> ## Documentation Index > Fetch the complete documentation index at: https://docs.answeringagent.com/llms.txt > Use this file to discover all available pages before exploring further. # Download a call recording > The call audio. Supports the Range header. Returns 404 when the conversation has no recording. Check has_recording on the conversation first. Customer API. ## OpenAPI ````yaml /openapi.yaml get /conversations/{conversation_id}/recording openapi: 3.0.0 info: title: Answering Agent API description: > The Customer API reads a team's conversations, transcripts, recordings, tasks, contacts, and reports. It also updates tasks and adds notes to them. The Partner API lets reseller accounts manage organizations, users, locations, partner links, and embed tokens. Both use an X-API-KEY header. Requests from this playground go to production. version: 1.0.0 servers: - url: https://answeringagent.com/api/v1 description: Production security: [] tags: - name: Account description: Customer API. Your team, phone lines, and members. - name: Conversations description: >- Customer API. Calls, texts, website chats, and emails, with transcripts and recordings. - name: Tasks description: >- Customer API. Follow-up tasks. Read them, update their status or assignee, and add notes. - name: Contacts description: Customer API. Your customers. - name: Reports description: Customer API. Report metrics, totals, and breakdowns. - name: Organizations description: Partner API, reseller accounts only. - name: Users description: Partner API, reseller accounts only. - name: Locations description: Partner API, reseller accounts only. - name: Account Linking description: Partner API, reseller accounts only. - name: Embed Tokens description: Partner API, reseller accounts only. paths: /conversations/{conversation_id}/recording: get: tags: - Conversations summary: Download a call recording description: > The call audio. Supports the Range header. Returns 404 when the conversation has no recording. Check has_recording on the conversation first. Customer API. operationId: getConversationRecording parameters: - $ref: '#/components/parameters/ConversationId' - in: header name: Range required: false schema: type: string example: bytes=0-1048575 description: Request part of the file. responses: '200': description: The recording. Read Content-Type for the audio format. content: audio/mpeg: schema: type: string format: binary audio/ogg: schema: type: string format: binary '206': description: Part of the recording, for a Range request. content: audio/mpeg: schema: type: string format: binary audio/ogg: schema: type: string format: binary '401': $ref: '#/components/responses/CustomerUnauthorized' '403': $ref: '#/components/responses/CustomerForbidden' '404': $ref: '#/components/responses/CustomerNotFound' '405': $ref: '#/components/responses/CustomerMethodNotAllowed' '416': description: >- The Range header is malformed or falls outside the file. Only returned when the recording provider supports byte ranges. Otherwise an out-of-range request returns 404. content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: Invalid range. code: invalid_request '429': $ref: '#/components/responses/CustomerRateLimited' '502': description: >- The recording provider failed or returned no audio. Retry later. Some recordings report a provider failure as 404 or 500 instead. content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: Audio not available. code: internal '503': description: >- The recording service is unavailable. Retry later. Some recordings report an outage as 404 or 500 instead. content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: Audio service unavailable. code: internal security: - ApiKeyAuth: [] components: parameters: ConversationId: in: path name: conversation_id required: true schema: type: integer minimum: 1 description: The conversation ID. responses: CustomerUnauthorized: description: >- The X-API-KEY header is missing, the key is wrong or revoked, or its owner was deactivated. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerForbidden: description: The key's owner is not an owner, admin, or manager on the team. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerNotFound: description: The record does not exist, or the key's owner cannot see it. content: application/json: schema: $ref: '#/components/schemas/CustomerError' CustomerMethodNotAllowed: description: The endpoint does not support that HTTP method. Nothing changed. headers: Allow: description: The methods the endpoint supports, such as GET, HEAD, OPTIONS. schema: type: string content: application/json: schema: $ref: '#/components/schemas/CustomerError' example: error: This endpoint accepts GET. code: method_not_allowed CustomerRateLimited: description: More than 120 requests in a minute for this user. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/CustomerError' schemas: CustomerError: type: object required: - error - code properties: error: type: string description: A message for people. The text can change. example: That conversation is not available. code: type: string description: A stable code to branch on. enum: - invalid_request - unauthorized - forbidden - not_found - method_not_allowed - conflict - unprocessable - rate_limited - internal example: not_found issues: type: array description: >- Present when code is invalid_request. One entry for each input that failed validation. items: type: object properties: path: type: array items: {} message: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.