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

{
  "object": "list",
  "data": [
    {
      "id": "rec_01HABC987654321",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "mixed",
      "duration": 245.3,
      "format": "mp3",
      "size": 2943600,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    },
    {
      "id": "rec_01HABC987654322",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "agent",
      "duration": 245.3,
      "format": "wav",
      "size": 7839360,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    },
    {
      "id": "rec_01HABC987654323",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "customer",
      "duration": 245.3,
      "format": "wav",
      "size": 7839360,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    }
  ],
  "session_id": "sess_01HXYZ123456789"
}
List all recordings associated with a session. A session may have multiple recordings if there were separate audio channels or if recording was paused and resumed.

​
Path Parameters

​
id
string
required
The unique session identifier (e.g., sess_01HXYZ123456789).

​
Query Parameters

​
channel
string
Filter by audio channel:
  • agent - Agent channel only
  • customer - Customer channel only
  • mixed - Combined audio

​
Response

​
object
string
Always list.
​
data
array
Array of recording objects.
​
session_id
string
The session these recordings belong to.
curl "https://api.kallglot.com/v1/sessions/sess_01HXYZ123456789/recordings" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "object": "list",
  "data": [
    {
      "id": "rec_01HABC987654321",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "mixed",
      "duration": 245.3,
      "format": "mp3",
      "size": 2943600,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    },
    {
      "id": "rec_01HABC987654322",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "agent",
      "duration": 245.3,
      "format": "wav",
      "size": 7839360,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    },
    {
      "id": "rec_01HABC987654323",
      "object": "recording",
      "session_id": "sess_01HXYZ123456789",
      "channel": "customer",
      "duration": 245.3,
      "format": "wav",
      "size": 7839360,
      "status": "ready",
      "created_at": "2026-03-26T11:04:20Z",
      "expires_at": "2026-04-26T11:04:20Z"
    }
  ],
  "session_id": "sess_01HXYZ123456789"
}

​
Recording Types

When dual-channel recording is enabled (the default), you’ll receive three recordings:
ChannelDescription
mixedCombined stereo audio with agent on left, customer on right
agentAgent audio only (mono)
customerCustomer audio only (mono)

​
Retention Policy

Recordings are retained based on your plan:
PlanDefault RetentionMax Retention
Starter7 days30 days
Pro30 days90 days
Enterprise90 daysUnlimited
You can configure retention settings in your organization settings or per-session via the recording.retention_days parameter when creating a session.