List Recordings
Retrieve a paginated list of completed recordings.
GET
https://api.identitycall.com/api/v1/public/recordingsReturns a list of recordings with their status and metadata.
Requires read permission
Query Parameters
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | 1 | Page number |
per_page | integer | No | 20 | Items per page (1-100) |
status | string | No | - | Filter by transcription status |
Request
cURL
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
| Field | Type | Description |
|---|---|---|
id | integer | Unique recording ID |
name | string | Recording display name |
status | string | Transcription status (pending, processing, completed, failed) |
duration_ms | integer | Recording duration in milliseconds |
created_at | string | ISO 8601 timestamp |
speakers | array | List of speaker labels |
goal_achievement | number | Percentage of goals met (0-100) |