<!-- Source: https://docs.vinsi.ai/api-docs/export-calls -->
# Export Calls

Convert call records into a CSV file (text/csv). The endpoint does not look calls up: send the call objects to include in the calls array, for example the calls returned by Get Calls or Get Call by ID. Columns: ID, AgentID, Call number, Agent, Outgoing, Incoming, Disposition, Start Time, End Time, Duration, Status, Summary, Transcript, Data, Error. Returns 400 when calls is empty.

```http
POST https://dashboard.vinsi.ai/api/calls/export
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Example request body

```json
{
  "calls": [
    {
      "id": "c_1757964000123",
      "agentId": "cmexampleagent000000000001",
      "agentName": "Front Desk Agent",
      "number": 48213,
      "incomingPhone": "+15555550142",
      "outgoingPhone": "+15555550199",
      "disposition": "Appointment Booked",
      "startTime": "2026-09-15T18:02:11.000Z",
      "endTime": "2026-09-15T18:03:45.000Z",
      "duration": 94,
      "status": "completed",
      "summary": "Caller booked a cleaning appointment.",
      "transcript": "Agent: Thank you for calling...",
      "data": {}
    }
  ]
}
```

## Example request

```bash
curl -X POST 'https://dashboard.vinsi.ai/api/calls/export' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"calls":[{"id":"c_1757964000123","agentId":"cmexampleagent000000000001","agentName":"Front Desk Agent","number":48213,"incomingPhone":"+15555550142","outgoingPhone":"+15555550199","disposition":"Appointment Booked","startTime":"2026-09-15T18:02:11.000Z","endTime":"2026-09-15T18:03:45.000Z","duration":94,"status":"completed","summary":"Caller booked a cleaning appointment.","transcript":"Agent: Thank you for calling...","data":{}}]}'
```

## Example response

```json
"ID,AgentID,Call number,Agent,Outgoing,Incoming,Disposition,Start Time,End Time,Duration,Status,Summary,Transcript,Data,Error\n\"c_1757964000123\",\"cmexampleagent000000000001\",\"C-48213\",\"Front Desk Agent\",\"+15555550199\",\"+15555550142\",\"Appointment Booked\",\"2026-09-15 18:02:11\",\"2026-09-15 18:03:45\",\"1:34\",\"completed\",\"Caller booked a cleaning appointment.\",\"Agent: Thank you for calling...\",\"\",\"\""
```