> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Get recording download link > Returns a fresh signed link to download a call's recording, valid for 60 minutes. The link works without an Allo login: do not share it beyond the people who may hear the call. Only a user who can play the recording in Allo gets one, and never for a call on a HIPAA-enabled team. **Required scope:** `CONVERSATIONS_READ` Returns a fresh link that downloads a call's recording, valid for 60 minutes. Use it when the `recording_download_url` you received has expired, or when you need a link on demand. The endpoint works on every account, not only on accounts created by a partner. * `{id}` is a call ID (`cll-*`). An ID with an unrecognized prefix returns `400 INVALID_ITEM_ID`. * `url` downloads the recording file with no Allo login. Anyone who has the link can download the recording until `expires_at`, so do not share it beyond the people allowed to hear the call. * `expires_at` is 60 minutes after the request. Call the endpoint again for a new link. ## Who can get the link The user of the API key must be able to play the recording in Allo: the line owner, a team admin or manager, a member the line is shared with, or the recipient of a summary share. Anyone else gets `403 RECORDING_ACCESS_DENIED`. Allo never creates a download link for a call on a HIPAA-enabled team. Those calls return `403 RECORDING_DOWNLOAD_RESTRICTED`: listen to the recording in the Allo app instead. ## Errors | Code | What it means | | - | - | | `CONVERSATION_ITEM_NOT_FOUND` | No call with this ID is visible to the key's user (`404`). | | `RECORDING_NOT_FOUND` | The call has no recording, or the ID is an SMS (`msg-*`) (`404`). Only answered calls on lines with call recording on have one. | | `RECORDING_ACCESS_DENIED` | The key's user cannot play this recording (`403`). | | `RECORDING_DOWNLOAD_RESTRICTED` | The line belongs to a HIPAA-enabled team (`403`). | | `RECORDING_DOWNLOAD_UNAVAILABLE` | The link could not be created (`500`). Always `retryable: true`: retry in a few seconds. | ## OpenAPI ````yaml GET /v2/api/conversations/items/{id}/recording openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. - name: Notes description: >- Internal team notes on conversations and CRM people, with @mention support. Notes are never visible to the contact. - name: Threads description: >- Team discussion threads attached to a conversation item (call, SMS, or conversation note). One thread per item. - name: AI Receptionist description: >- Read and write the AI receptionist configuration of a phone line: business details, voice, prompt, capabilities, business hours, transfer rules, scheduling calendars and knowledge sources. paths: /v2/api/conversations/items/{id}/recording: get: tags: - Conversations summary: Get recording download link description: >- Returns a fresh signed link to download a call's recording, valid for 60 minutes. The link works without an Allo login: do not share it beyond the people who may hear the call. Only a user who can play the recording in Allo gets one, and never for a call on a HIPAA-enabled team. operationId: getConversationItemRecording parameters: - name: id in: path required: true description: Call ID (`cll-*`). schema: type: string example: cll-abc123 responses: '200': description: Download link content: application/json: schema: type: object properties: data: type: object properties: url: type: string description: >- Signed link that downloads the recording, with no login. example: >- https://storage.withallo.com/object/sign/recordings/abc123.mp3?token=eyJhbGciOi... expires_at: type: string format: date-time description: >- When the link stops working, 60 minutes after the request. example: '2026-10-19T15:30:00Z' example: data: url: >- https://storage.withallo.com/object/sign/recordings/abc123.mp3?token=eyJhbGciOi... expires_at: '2026-10-19T15:30:00Z' '400': description: The ID has an unrecognized prefix (INVALID_ITEM_ID). content: application/json: schema: type: object properties: error: type: object '401': $ref: '#/components/responses/ApiUnauthorized' '403': description: >- The API key lacks the CONVERSATIONS_READ scope, the key's user cannot play this recording (RECORDING_ACCESS_DENIED), or the line belongs to a HIPAA-enabled team (RECORDING_DOWNLOAD_RESTRICTED). content: application/json: schema: type: object properties: error: type: object '404': description: >- No call with this ID (CONVERSATION_ITEM_NOT_FOUND), or the item has no recording (RECORDING_NOT_FOUND). An SMS (`msg-*`) has no recording. content: application/json: schema: type: object properties: error: type: object '429': $ref: '#/components/responses/ApiRateLimited' '500': description: >- The download link could not be created (RECORDING_DOWNLOAD_UNAVAILABLE). Retry in a few seconds. content: application/json: schema: type: object properties: error: type: object security: - ApiKeyAuth: [] components: responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' schemas: ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.