Export calls history

POST/call/export

Export calls as a CSV file, one line per call, selected with the filters of POST /call/search. Large exports are split into files of at most 4 MB: when the response carries a non-null next_offset, call the endpoint again with that value as offset to get the next file.

Request

curl -X POST "https://www.getrevox.com/api/call/export" \
  -H "Authorization: Bearer $REVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "campaign_ids": ["9b2d7e41-6c3f-4a8e-b5d0-2f7a1c9e4b63"],
      "outcomes": ["interested"]
    },
    "include_structured_output_fields": true,
    "include_metadata": true
  }'

const res = await fetch("https://www.getrevox.com/api/call/export", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    filters: {
      campaign_ids: [
        "9b2d7e41-6c3f-4a8e-b5d0-2f7a1c9e4b63",
      ],
      outcomes: [
        "interested",
      ],
    },
    include_structured_output_fields: true,
    include_metadata: true,
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.post(
    "https://www.getrevox.com/api/call/export",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    json={
        "filters": {
            "campaign_ids": [
                "9b2d7e41-6c3f-4a8e-b5d0-2f7a1c9e4b63",
            ],
            "outcomes": [
                "interested",
            ],
        },
        "include_structured_output_fields": True,
        "include_metadata": True,
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

One line per call of the campaign whose outcome is interested, with a column per extracted value and per metadata key.

Try itSend this request live

Response

Success

{
  "csv": "id,to_phone_number,status,outcome\n6f9a3c1e,+33612345678,completed,interested",
  "filename": "calls-2026-11-05.csv",
  "next_offset": 1
}

Request body

application/json

filtersobjectrequired
Which calls to export, as in POST /call/search; page and page_size select the window of calls to export. to_phone_number and call_ids are not applied.
offsetinteger
Number of already-exported rows to skip, within the filters' page/page_size window. Pass the next_offset value from the previous response to fetch the next file of a split export.
Default 0≥ 0
include_structured_output_fieldsboolean
Add one column per value extracted from the last attempt, named structured_output-<field>.
include_metadataboolean
Add one column per metadata key, named metadata-<key>.

Response

200

csvstring
The CSV file content, one line per call, with a header line.
filenamestring
Suggested file name, e.g. 'revox-call-history-<ISO timestamp>.csv', with the row range appended for a split export.
next_offsetintegernullable
Non-null when the export was split because this file reached the 4MB cap: pass it as offset in a follow-up call to get the next file. Null when this file completes the export.