---
title: "Get Call Recording"
method: GET
path: "/v2/Recording/{clientId}/{pearlId}/{callId}"
tags: ["Recording"]
---

# Get Call Recording

`GET /v2/Recording/{clientId}/{pearlId}/{callId}`

## Request

- Base URL: `https://api.nlpearl.ai`
- URL: `https://api.nlpearl.ai/v2/Recording/{clientId}/{pearlId}/{callId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nlpearl/apis/nlpearl-client-api/docs/v2/Recording/:clientId/:pearlId/:callId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the audio recording for a specific call. If the client has public recordings enabled, the endpoint can be accessed anonymously; otherwise, a valid Authorization header matching the client is required. Recordings hosted on Twilio are returned as a permanent redirect, while recordings stored internally are converted from WAV to Opus (audio/ogg) and streamed back with range processing enabled for browser seeking.

## Path parameters

- `clientId` string, required
- `pearlId` string, required
- `callId` string, required

## Response `200`

The audio recording in Opus format (audio/ogg).

- string, binary

## Other responses

- `400`: One or more provided IDs are not valid ObjectIds.
- `401`: The client does not allow public recordings and the request is not properly authenticated for the given client.
- `404`: No recording was found for the specified call.
- `500`: Failed to process the recording (e.g., conversion error).

---

[API](https://skmtc.dev/nlpearl/apis/nlpearl-client-api.md) - [All operations](https://skmtc.dev/nlpearl/apis/nlpearl-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nlpearl/apis/nlpearl-client-api/revisions/52d64fc5d6e9?raw)