Get Recording
Retrieve details about a specific recording.
GET
https://api.identitycall.com/api/v1/public/recordings/:idGet detailed information about a recording including processing status.
Requires read permission
Path Parameters
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | - | Recording ID |
Request
cURL
curl -X GET "https://api.identitycall.com/api/v1/public/recordings/123" \
-H "Authorization: Bearer $IDENTITYCALL_API_KEY"Response
Response200 OK
{
"data": {
"id": 123,
"name": "Sales Call - John Smith",
"status": "completed",
"language": "en",
"duration_ms": 185000,
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T10:32:45Z",
"dialogues_count": 24,
"goals_evaluated": true,
"keywords_detected": 8,
"pauses_detected": 3,
"audio_attached": true
}
}Response Fields
| Field | Type | Description |
|---|---|---|
id | integer | Unique recording ID |
name | string | Recording display name |
status | string | Transcription status |
language | string | Language code |
duration_ms | integer | Recording duration in milliseconds |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
dialogues_count | integer | Number of dialogue segments |
goals_evaluated | boolean | Whether goals have been evaluated |
keywords_detected | integer | Number of keyword detections |
pauses_detected | integer | Number of detected pauses |
audio_attached | boolean | Whether audio file is available |
Recording Status
| Status | Description |
|---|---|
pending | Recording uploaded, waiting for processing |
processing | Transcription in progress |
completed | Transcription finished, results available |
failed | Processing failed (check error details) |
Errors
| Status | Error | Description |
|---|---|---|
| 404 | ”Resource not found” | Recording doesn’t exist or isn’t accessible |