Skip to Content
API ReferenceRecordingsCreate Recording

Upload Recording

Upload an audio file to create a new recording and start transcription.

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

Upload an audio file for transcription and analysis.

Requires write permission

Request Body

Body Parameters (multipart/form-data)

NameTypeRequiredDefaultDescription
filefileYes-Audio file (MP3, WAV, M4A, OGG, FLAC, WebM)
languagestringNoenLanguage code (en, es, fr, de, etc.)
namestringNo-Display name for the recording

Request

curl -X POST "https://api.identitycall.com/api/v1/public/recordings" \ -H "Authorization: Bearer $IDENTITYCALL_API_KEY" \ -F "file=@call-recording.mp3" \ -F "language=en" \ -F "name=Sales Call - John Smith"

Response

Response201 Created
{
"data": {
  "id": 125,
  "status": "pending",
  "created_at": "2025-01-15T14:22:00Z"
}
}

Response Fields

FieldTypeDescription
idintegerUnique recording ID
statusstringInitial status (always “pending”)
created_atstringISO 8601 timestamp

Transcription is asynchronous. Poll the Get Recording endpoint to check when processing is complete.

Supported Audio Formats

FormatExtensionMax Size
MP3.mp3100 MB
WAV.wav500 MB
M4A.m4a100 MB
OGG.ogg100 MB
FLAC.flac500 MB
WebM.webm100 MB

Supported Languages

CodeLanguage
enEnglish
esSpanish
frFrench
deGerman
itItalian
ptPortuguese
nlDutch
plPolish
ruRussian
jaJapanese
koKorean
zhChinese

Errors

StatusErrorDescription
400”file is required”No file was uploaded
422”Invalid file type”Unsupported audio format
422”File too large”File exceeds size limit

Try It

Try It