---
title: "List CDRs"
method: GET
path: "/v1/cdrs"
tags: ["CDRs"]
---

# List CDRs

`GET /v1/cdrs`

Returns a paginated list of call detail records for the authenticated account, within the requested date range.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `type` string, required
- `disposition` 'answered' | 'noanswer' | 'busy' | 'failed' | 'all' — Final disposition of the call. One of `answered` (the called party answered), `noanswer` (no answer within the ring timeout), `busy` (the called party was busy), `failed` (the call could not be routed), or `all` (matches any disposition when used as a filter).
- `from_search` string
- `to_search` string
- `sip_trunk` string
- `uuid` string
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of CDRs.

- CDRListResponse
  - `items` CDR[], required — List of CDRs
    - `date` string, date-time, required — Date and time of the call in ISO 8601 format.
    - `from` string, required — Originating phone number (ANI).
    - `to` string, required — Destination phone number (DNIS).
    - `disposition` 'answered' | 'noanswer' | 'busy' | 'failed' | 'all', required — Final disposition of the call. One of `answered` (the called party answered), `noanswer` (no answer within the ring timeout), `busy` (the called party was busy), `failed` (the call could not be routed), or `all` (matches any disposition when used as a filter).
    - `duration` integer, required — Call duration in seconds.
    - `destination` string, required — Destination of the call. For outbound calls, contains the country name and, optionally, a mobile carrier or city name. For inbound calls, includes the SIP trunk name, SIP URI, or PSTN number the call is forwarded to.
    - `per_minute` string, required — Price per minute in USD.
    - `charge` string, required — Total charge for the call in USD.
    - `sip_trunk` string, nullable — System-generated SIP trunk login. For outbound calls only.
    - `forward_fee` string — PSTN forwarding price in USD. For inbound calls only when forwarded to PSTN.
    - `uuid` string, required — Call ID. Deprecated — use `call_id` instead.
    - `call_id` string, required — Call ID. Alias of `uuid`.
    - `parent_uuid` string, nullable — Parent call ID. Deprecated — use `parent_call_id` instead.
    - `parent_call_id` string, nullable — Parent call ID. Alias of `parent_uuid`.
    - `answered_by` string, nullable — Who answered the call. Possible values are `human`, `machine`.
  - `pagination` Pagination, required
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)