---
title: "List call recordings"
method: GET
path: "/v1/recordings"
tags: ["Call recording"]
---

# List call recordings

`GET /v1/recordings`

Returns a paginated list of call recordings for the authenticated account, filtered by date range, number, call, or SIP trunk.

## Query parameters

- `from_date` string, date
- `to_date` string, date
- `from` string
- `to` string
- `call_uuid` string
- `sip_trunks` string[]
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of call recordings.

- CallRecordingListResponse
  - `recordings` Recording[] — Call recordings that match the request.
    - `id` integer, required — Recording ID.
    - `created_at` string, date-time, required — Date and time when the recording was created in ISO 8601 format.
    - `duration` integer, required — Recording duration in seconds.
    - `from` string, required — Originating phone number.
    - `to` string, required — Destination phone number.
    - `call_uuid` string, required — Call ID.
    - `url` string, required — Recording file URL.
  - `invalid` InvalidRecording — An invalid recording filter response
    - `dids` string[] — Phone number IDs that did not match any recording.
    - `sip_trunks` string[] — SIP trunk IDs that did not match any recording.
  - `pagination` Pagination
    - `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>
- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

## Changes

- **2026-09-08** `6a89c962481c` — 1 info
  - added the non-success response with the status `400`
- **2026-05-25** `33be77905120` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1` — 1 warning, 5 info
  - deleted the `query` request parameter `dids`
  - api operation id `Getcallrecordings` removed and replaced with `call_recording_list`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
  - …2 more
- **2026-02-12** `fabaadf195a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/recordings/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/43ad912a102a?raw)