Calls

Export calls

Export the historical calls matching a filter as a downloadable CSV file. The response is a complete CSV encoded with a UTF-8 BOM so Arabic and other non-ASCII text render correctly in Excel. Accepts the same SearchCallsRequest filter body as the search and analytics endpoints. Use it to extract call data for offline reporting or import into spreadsheets and BI tools.

POST

https://api.nabrah.ai/api/ext/call/export

Export calls

curl --request POST \
  --url 'https://api.nabrah.ai/api/ext/call/export' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "created_at_start": "2026-06-01T00:00:00.000Z",
  "created_at_end": "2026-06-23T23:59:59.000Z"
}'

// No example body for this response.

Filtering

The body is a SearchCallsRequest; send only the fields you want to constrain. Everything matching the filter is exported.

Time windows

call_started_at_start / call_started_at_end filter on call start time; created_at_start / created_at_end filter on record creation time.

call_started_at_startcall_started_at_endcreated_at_startcreated_at_end

Scope

agent_id, call_from, call_to, status, call_type, tags/tag, and q work exactly as in POST /api/ext/call/search.

agent_idcall_fromcall_tostatuscall_typetagstagq

Analysis filters

analysis_filters restricts by analysis values; each entry is { name, op, value }.

nameopvalue

The endpoint returns the full filtered set as one CSV; limit/offset are not used for row windowing here. The file is UTF-8 with a BOM — open it directly in Excel for correct Arabic display.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Body

application/json

Export every call created in a date range.

Minimal

{
  "created_at_start": "2026-06-01T00:00:00.000Z",
  "created_at_end": "2026-06-23T23:59:59.000Z"
}

Response

200

Successful Response

application/json

422

Validation Error

application/json