Skip to Content

Get Recording

Retrieve details about a specific recording.

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

Get detailed information about a recording including processing status.

Requires read permission

Path Parameters

Parameters

NameTypeRequiredDefaultDescription
idintegerYes-Recording ID

Request

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

FieldTypeDescription
idintegerUnique recording ID
namestringRecording display name
statusstringTranscription status
languagestringLanguage code
duration_msintegerRecording duration in milliseconds
created_atstringISO 8601 creation timestamp
updated_atstringISO 8601 last update timestamp
dialogues_countintegerNumber of dialogue segments
goals_evaluatedbooleanWhether goals have been evaluated
keywords_detectedintegerNumber of keyword detections
pauses_detectedintegerNumber of detected pauses
audio_attachedbooleanWhether audio file is available

Recording Status

StatusDescription
pendingRecording uploaded, waiting for processing
processingTranscription in progress
completedTranscription finished, results available
failedProcessing failed (check error details)

Errors

StatusErrorDescription
404”Resource not found”Recording doesn’t exist or isn’t accessible

Try It

Try It