> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unpod.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Introduction to the Call Detail Records (CDR) API

# Call Detail Records (CDR) API

The CDR API allows you to retrieve telephony call detail records for your organization. It provides comprehensive call details including duration, status, timestamps, and source/destination numbers.

<Note>
  **Note:** This API only returns SIP-based telephony calls (`product_types: telephony_sip`), not voice agent calls.
</Note>

<Note>
  **Prerequisites:** Make sure you have your API Token and Org-Handle ready. See [Authentication](/api/get-started/authentication) for details.
</Note>

## What You Can Do

| Endpoint                    | Description                                             |
| --------------------------- | ------------------------------------------------------- |
| `GET /api/v2/platform/cdr/` | Retrieve all telephony CDRs with filtering & pagination |

## Base URL

```
https://unpod.ai/api/v2/platform/
```

## Authentication

All CDR API requests require a valid API token and Org-Handle in the headers:

```http theme={null}
Authorization: Token your-api-token
Org-Handle: your-org-handle
```

## Available Filters

| Filter        | Description                                        |
| ------------- | -------------------------------------------------- |
| `page`        | Page number for pagination                         |
| `page_size`   | Number of records per page                         |
| `call_type`   | Filter by `inbound` or `outbound`                  |
| `call_status` | Filter by `completed`, `notConnected`, or `failed` |

## Common Error Codes

| Status Code | Description                                 |
| ----------- | ------------------------------------------- |
| 200         | Success - Request completed successfully    |
| 400         | Bad Request - Invalid parameters provided   |
| 401         | Unauthorized - Invalid or missing API token |
| 403         | Forbidden - Invalid organization handle     |
| 500         | Internal Server Error - Server-side error   |