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

# Download a call recording

> The call's audio file (usually `audio/mpeg`), streamed as raw bytes. Use the `recording_url` on a call from `GET /v1/history/calls`, or build it from the call id. 404 when the call has no recording, recording was turned off for it, or it is not in your workspace. Every download is recorded in your compliance audit log. Free: reads are never billed.



## OpenAPI

````yaml /openapi.json get /v1/history/calls/{id}/recording
openapi: 3.1.0
info:
  title: LumisReach v1 API
  version: 1.0.0
  description: >-
    Programmatic access to the LumisReach voice platform — calls, numbers,
    caller trust, and brands.
  contact:
    name: LumisReach
    email: founders@lumisreach.com
servers:
  - url: https://api.lumisreach.com/api
security:
  - bearerAuth: []
tags:
  - name: Phone Numbers
  - name: Caller IDs
  - name: Enterprise Registration
  - name: Branded Calling
  - name: Calls
  - name: SMS
  - name: WebRTC
  - name: Reputation
  - name: Usage
  - name: Account
  - name: Conversation History
  - name: Documents
  - name: Quick Agent Actions
  - name: Sub-entities
paths:
  /v1/history/calls/{id}/recording:
    get:
      tags:
        - Conversation History
      summary: Download a call recording
      description: >-
        The call's audio file (usually `audio/mpeg`), streamed as raw bytes. Use
        the `recording_url` on a call from `GET /v1/history/calls`, or build it
        from the call id. 404 when the call has no recording, recording was
        turned off for it, or it is not in your workspace. Every download is
        recorded in your compliance audit log. Free: reads are never billed.
      operationId: v1_history_calls_id_recording_get
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The recording's audio bytes
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: Conflict (incl. idempotency conflicts)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  schemas:
    ErrorEnvelope:
      type: object
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
            fields:
              type: object
              additionalProperties:
                type: string
            doc_url:
              type: string
              format: uri
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````