Skip to main content
GET
/
accounts
/
{account_id}
/
recordings
JavaScript
import Surge from '@surgeapi/node';

const client = new Surge({
  apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const recordingListResponse of client.recordings.list(
  'acct_01j9a43avnfqzbjfch6pygv1td',
)) {
  console.log(recordingListResponse.id);
}
{
  "data": [
    {
      "call": {
        "contact": {
          "email": "dom@toretto.family",
          "first_name": "Dominic",
          "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
          "last_name": "Toretto",
          "metadata": {
            "car": "1970 Dodge Charger R/T"
          },
          "phone_number": "+18015551234"
        },
        "duration": 184,
        "id": "call_01jjnn7s0zfx5tdcsxjfy93et2",
        "initiated_at": "2025-03-31T21:01:37Z",
        "status": "completed"
      },
      "duration": 124,
      "id": "rec_01kfyc9dgdec1avkgs7tng8htg"
    }
  ],
  "pagination": {
    "next_cursor": "g3QAAAABZAACaWRtAAAAGnBuXzAxamtzY2s5eDdkeW0wZnBxZjdjYmRyeQ==",
    "previous_cursor": null
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.surge.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
account_id
string
required

The account ID to list recordings for.

Example:

"acct_01j9a43avnfqzbjfch6pygv1td"

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

List of recordings

A paginated list of recordings

​
data
Recording · object[]
required

The list of recordings

​
pagination
Pagination · object
required

Cursor-based pagination information

Example:
{
  "next_cursor": "g3QAAAABZAACaWRtAAAAGnBuXzAxamtzY2s5eDdkeW0wZnBxZjdjYmRyeQ==",
  "previous_cursor": null
}