---
title: "Download Call History"
method: POST
path: "/calling/history/download"
tags: ["calling"]
---

# Download Call History

`POST /calling/history/download`

Downloads call history data in CSV format. Supports bulk download of call records with optional filtering. Use 'include_analysis=true' to include call analysis data (platform_analysis and client_analysis) in the export.

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time
- `agent_id` string[]
- `status` 'registered' | 'ongoing' | 'retry' | 'error' | 'completed' | 'failed' | 'cancelled' | 'forwarded'
- `include_analysis` boolean
- `call_type` 'inbound' | 'outbound' | 'webcall'
- `bulk_list_id` string
- `voicemail` boolean
- `from_number` string
- `to_number` string
- `call_id` string
- `limit` integer
- `offset` integer

## Headers

- `X-API-KEY` string, required

## Response `200`

Call history download successful

- object
  - `message` string — Success message when email format is used

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/revisions/00b614a7714c/schema)