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": "https://storage.kallglot.com/recordings/rec_01HABC987654321?signature=xxx&expires=1711454400",
  "created_at": "2026-03-26T11:04:20Z",
  "expires_at": "2026-04-26T11:04:20Z"
}
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
Pre-signed URL for downloading the recording. Valid for 1 hour.
​
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": "https://storage.kallglot.com/recordings/rec_01HABC987654321?signature=xxx&expires=1711454400",
  "created_at": "2026-03-26T11:04:20Z",
  "expires_at": "2026-04-26T11:04:20Z"
}

​
Notes

The download_url is a pre-signed URL that expires after 1 hour. Request a new one by calling this endpoint again.
Recordings are automatically deleted based on your retention policy. After the expires_at date, the recording will no longer be available.