---
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

- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

---

[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)