Skip to main content
GET
Retrieve the metadata for a specific recording by its ID.

Path Parameters

id
string
required
The unique recording identifier (e.g., rec_01HABC987654321).

Response

id
string
Unique recording identifier.
object
string
Always recording.
session_id
string
The session this recording belongs to.
channel
string
Audio channel: agent, customer, or mixed.
status
string
Recording status:
  • processing - Recording is being processed
  • ready - Recording is available for download
  • failed - Recording generation failed
duration
number
Recording duration in seconds.
format
string
Audio format (e.g., mp3, wav).
size
number
File size in bytes.
sample_rate
number
Audio sample rate in Hz.
bit_depth
number
Audio bit depth.
download_url
string
When the file is ready, a relative path such as /v1/recordings/{id}/audio. Call it on https://api.kallglot.com with your API key (no separate download token in the response contract).
created_at
string
Creation timestamp (ISO 8601).
expires_at
string
When the recording will be deleted based on retention policy (ISO 8601).

Notes

When download_url is present it points at the /v1/recordings/{id}/audio path on https://api.kallglot.com. Use your normal API key—there is no separate download token in the REST contract.
Recordings are automatically deleted based on your retention policy. After the expires_at date, the recording will no longer be available.