Quickstart
The Call Export API lets a partner or white-label customer retrieve its own voice-AI call history from SimZ: call metadata for any time window, full transcripts, and recording downloads. It is read-only and scoped to your company — a key issued to your company can never see another company’s calls.
Base path
Authentication
Every request carries a company API key with the calls:read scope in the X-Company-API-Key header. A company admin creates it in the SimZ portal under API Access → API Keys; the full key is shown once. Up to two keys can be active at the same time so you can rotate without downtime.
The Call Export API must be enabled for your company by SimZ before keys can be created. Contact your SimZ representative if the API Keys tab is not visible.
First request
Response envelope
All JSON responses share one shape and carry an X-Request-Id header. Quote the request ID when you contact SimZ support.
Recommended sync loop
- Every 15 minutes call
GET /callswithfrom= thetoof your previous successful run,to= now,include=transcript,limit=100. Followpagination.next_cursoruntilhas_moreisfalse. - Persist each
call_idand skip IDs you already stored. - For items whose
recording.statusisavailable, downloadrecording.pathright away. - Items that were
processing(call still in progress or still being transcribed) are re-checked on the next run withPOST /calls/retrieve. - Retry
429afterRetry-Afterseconds and503with exponential backoff. Every endpoint is read-only and safe to retry.
Data retention
Recordings are kept for 90 days and transcripts for 180 days after the call. Older artifacts are reported with status: "expired". Plan your backfill accordingly.
What is and is not returned
Returned per call: identifiers, start/end time, duration, direction, status, the phone numbers, the captured client name, the handling agent, transcript (on request) and a recording download path.
Never returned: internal storage keys, telephony provider identifiers, prompt or model configuration, billing data.
Transcripts are returned as captured (not redacted).
