---
title: "Export calls"
method: POST
path: "/calls/export"
tags: ["Calls"]
---

# Export calls

`POST /calls/export`

Export calls to a CSV file. The CSV file will be available for download for 24 hours.
The export will be performed asynchronously. The task status can be checked with
the `Tasks` endpoints.

You cannot export more than 31 days of calls at once. If you need to export more
than 31 days,you will need to split the export in multiple requests.

Exporting calls is a heavy operation. It can take a long time to complete, depending
on the amount of calls to export. **That is why you are limited to a maximum of 5
exports per day.**

If you need to process calls in real-time, you should use webhooks, or the `fetch`
action with Callr Actions.

## Query parameters

- `direction` 'inbound' | 'outbound', required — The direction. Inbound is a call or an SMS received by the Callr platform. Outbound is a call or an SMS initiated by the Callr platform.
- `from` string, date-time, required — RFC 3339, section 5.6
- `to` string, date-time, required — RFC 3339, section 5.6
- `scenario` string — Short ID
- `number` string — A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"

## Response `202`

Export is running (Task ID in response)

- string — Task ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource Not Found
- `405` — Method Not Allowed
- `429` — Too Many Requests (rate limit exceeded)
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callr/apis/callr-rest-api-v2-0.md) · [All operations](https://skmtc.dev/callr/apis/callr-rest-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callr/callr-rest-api-v2-0/revisions/76d36d004a8f/schema)