Skip to main content
GET
/
v1
/
recordings
/
{id}
curl https://api.kallglot.com/v1/recordings/rec_01HABC987654321 \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "id": "rec_01HABC987654321",
  "object": "recording",
  "session_id": "sess_01HXYZ123456789",
  "channel": "mixed",
  "status": "ready",
  "duration": 245.3,
  "format": "mp3",
  "size": 2943600,
  "sample_rate": 44100,
  "bit_depth": 16,
  "download_url": "/v1/recordings/rec_01HABC987654321/audio",
  "created_at": "2026-03-26T11:04:20Z",
  "expires_at": "2026-04-26T11:04:20Z"
}

Documentation Index

Fetch the complete documentation index at: https://developer.kallglot.com/llms.txt

Use this file to discover all available pages before exploring further.

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).
curl https://api.kallglot.com/v1/recordings/rec_01HABC987654321 \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "id": "rec_01HABC987654321",
  "object": "recording",
  "session_id": "sess_01HXYZ123456789",
  "channel": "mixed",
  "status": "ready",
  "duration": 245.3,
  "format": "mp3",
  "size": 2943600,
  "sample_rate": 44100,
  "bit_depth": 16,
  "download_url": "/v1/recordings/rec_01HABC987654321/audio",
  "created_at": "2026-03-26T11:04:20Z",
  "expires_at": "2026-04-26T11:04:20Z"
}

​
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.