---
title: "List recordings"
method: GET
path: "/accounts/{account_id}/recordings"
tags: ["Recordings"]
---

# List recordings

`GET /accounts/{account_id}/recordings`

List all recordings for an account with cursor-based pagination.

## Path parameters

- `account_id` string, required — The account ID to list recordings for.

## Query parameters

- `after` string — Cursor for forward pagination. Use the next_cursor from a previous response.
- `before` string — Cursor for backward pagination. Use the previous_cursor from a previous response.

## Response `200`

List of recordings

- RecordingList — A paginated list of recordings
  - `data` Recording[], required — The list of recordings
    - `call` object, required — The call that produced this recording
      - `contact` Contact, required — A contact who has consented to receive messages
        - `email` string, email — The contact's email address.
        - `first_name` string — The contact's first name.
        - `id` string, required — Unique identifier for the object.
        - `last_name` string — The contact's last name.
        - `metadata` Metadata — Set of key-value pairs that will be stored with the object.
        - `outbound_disabled` boolean — Whether outbound messaging has been manually disabled for the contact.
        - `phone_number` string, phone-number, required — The contact's phone number in E.164 format.
      - `duration` integer, required — The duration of the call in seconds
      - `id` string, required — The unique identifier for the call
      - `initiated_at` string, date-time, required — When the call was initiated
      - `status` 'busy' | 'canceled' | 'completed' | 'failed' | 'in_progress' | 'missed' | 'no_answer' | 'queued' | 'ringing', required — The status of the call
    - `duration` integer, required — The duration of the recording in seconds
    - `id` string, required — The unique identifier for the recording
  - `pagination` Pagination, required — Cursor-based pagination information
    - `next_cursor` string, nullable — Cursor for the next page of results. Null if there is no next page.
    - `previous_cursor` string, nullable — Cursor for the previous page of results. Null if there is no previous page.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/revisions/33842756c9f9/schema)