> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Recordings

> List the recording files captured for a call.

Returns metadata for every recording file captured on a call. The array is empty when the call has no recordings or the recording was deleted.

Requires the `voice_calls.read` scope and the **Voice Calls** product entitlement.

## Path Parameters

<ParamField path="callId" type="string" required>
  The id of the call whose recordings to list.
</ParamField>

## Response Fields

<ResponseField name="files" type="array">
  The recording files for the call. Empty when there are none.

  <Expandable title="File properties" defaultOpen>
    <ResponseField name="files[].fileId" type="string">The recording file's provider id. Pass it to [Download a Recording File](/api-reference/voice/calls/download-recording).</ResponseField>
    <ResponseField name="files[].name" type="string">The file's name.</ResponseField>
    <ResponseField name="files[].fileFormat" type="string">The audio format, e.g. `wav`.</ResponseField>
    <ResponseField name="files[].size" type="integer">The file size in bytes.</ResponseField>
    <ResponseField name="files[].startTime" type="string">ISO 8601 timestamp when the recording started.</ResponseField>
    <ResponseField name="files[].endTime" type="string">ISO 8601 timestamp when the recording ended.</ResponseField>
  </Expandable>
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tracklysms.com/api/v1/voice/calls/665f1e2a9c4b1a0012ab34cd/recording \
    -H "X-Api-Key: trk_your_api_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "files": [
      {
        "fileId": "665f1e2a9c4b1a0012abd001",
        "name": "call-665f1e2a9c4b1a0012ab34cd-1.wav",
        "fileFormat": "wav",
        "size": 481624,
        "startTime": "2026-08-21T18:00:12.000000Z",
        "endTime": "2026-08-21T18:03:44.000000Z"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

| Status | Code                 | Meaning                                               |
| ------ | -------------------- | ----------------------------------------------------- |
| 403    | `voice_not_entitled` | Voice calling is not enabled for your account.        |
| 404    | `call_not_found`     | No call with that id exists on your account.          |
| 409    | `call_not_ready`     | The call has not yet been accepted by the provider.   |
| 502    | `provider_error`     | The upstream telephony provider rejected the request. |