Skip to Content
API ReferenceRecordingsList Recordings

List Recordings

Retrieve a paginated list of completed recordings.

GEThttps://api.identitycall.com/api/v1/public/recordings

Returns a list of recordings with their status and metadata.

Requires read permission

Query Parameters

Parameters

NameTypeRequiredDefaultDescription
pageintegerNo1Page number
per_pageintegerNo20Items per page (1-100)
statusstringNo-Filter by transcription status

Request

curl -X GET "https://api.identitycall.com/api/v1/public/recordings?page=1&per_page=20" \ -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Response

Response200 OK
{
"data": [
  {
    "id": 123,
    "name": "Sales Call - John Smith",
    "status": "completed",
    "duration_ms": 185000,
    "created_at": "2025-01-15T10:30:00Z",
    "speakers": ["Speaker 1", "Speaker 2"],
    "goal_achievement": 87.5
  },
  {
    "id": 124,
    "name": "Support Call #4521",
    "status": "completed",
    "duration_ms": 420000,
    "created_at": "2025-01-15T11:45:00Z",
    "speakers": ["Agent", "Customer"],
    "goal_achievement": 100.0
  }
],
"meta": {
  "current_page": 1,
  "total_pages": 5,
  "total_count": 98,
  "per_page": 20
}
}

Response Fields

FieldTypeDescription
idintegerUnique recording ID
namestringRecording display name
statusstringTranscription status (pending, processing, completed, failed)
duration_msintegerRecording duration in milliseconds
created_atstringISO 8601 timestamp
speakersarrayList of speaker labels
goal_achievementnumberPercentage of goals met (0-100)

Try It

Try It