# Get Recording

Retrieve information about a specific recording, including its transcription
status and transcript (if available).

Endpoint: GET /recording/{id}
Version: v1
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    Recording ID

## Response 200 fields (application/json):

  - `id` (string)
    Unique recording identifier

  - `status` (string)
    Current status of the recording
    Enum: "transcribing", "finished", "failed"

  - `webhook_url` (string,null)
    Webhook URL for receiving status updates

  - `recording_url` (string,null)
    URL to the original recording file

  - `recording_available_until` (string,null)
    When the recording will be deleted

  - `lang` (string,null)
    Language specified when creating the recording

  - `detected_lang` (string,null)
    Language detected from the audio

  - `transcript` (array)
    Transcript segments

  - `transcript.start` (number)
    Start time in seconds
    Example: 4

  - `transcript.end` (number)
    End time in seconds
    Example: 5.62

  - `transcript.speaker` (integer)
    Speaker ID

  - `transcript.speaker_name` (string,null)
    Name of the speaker (only available for transcription models which support speaker diarization).
This field is only present when we are confident we can link a specific participant to this speaker.
If no participant could be confidently linked to the speaker, this will be null and potential_speaker_names will be provided instead.
    Example: "John Doe"

  - `transcript.potential_speaker_names` (array,null)
    Array of potential speaker matches with confidence scores. This field is only present when we cannot confidently
link a single participant to the speaker. If speaker_name is provided, this field will be null.

  - `transcript.potential_speaker_names.name` (string)
    Name of the potential speaker
    Example: "John Doe"

  - `transcript.potential_speaker_names.confidence` (number)
    Confidence score for this speaker match
    Example: 0.64

  - `transcript.confidence` (number)
    Confidence score for transcript accuracy
    Example: 0.9980372

  - `transcript.transcript` (string)
    The transcribed text
    Example: "This is a quick test."

  - `transcript.utterances` (array)
    Detailed utterance information (model-specific)

  - `transcription_model` (string)
    Model used for transcription

  - `events` (array)
    List of processing events

  - `events.event` (string)
    Type of event
    Example: "status_update"

  - `events.data` (object)
    Event data

  - `events.data.old_status` (string)
    Example: "joining"

  - `events.data.new_status` (string)
    Example: "recording"

  - `events.created_at` (string)
    When the event occurred

  - `profanity_filter` (boolean)
    Whether profanity filter was enabled

  - `custom_vocabulary` (array)
    Words or phrases provided when creating meeting bot for transcription model

  - `created_at` (string)
    When the recording was uploaded

## Response 401 fields (application/json):

  - `message` (string)
    Error message
    Example: "Unauthenticated."

## Response 404 fields (application/json):

  - `message` (string)
    Error message
    Example: "No results found."