Upload Recording
Upload an audio file to create a new recording and start transcription.
POST
https://api.identitycall.com/api/v1/public/recordingsUpload an audio file for transcription and analysis.
Requires write permission
Request Body
Body Parameters (multipart/form-data)
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
file | file | Yes | - | Audio file (MP3, WAV, M4A, OGG, FLAC, WebM) |
language | string | No | en | Language code (en, es, fr, de, etc.) |
name | string | No | - | Display name for the recording |
Request
cURL
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
| Field | Type | Description |
|---|---|---|
id | integer | Unique recording ID |
status | string | Initial status (always “pending”) |
created_at | string | ISO 8601 timestamp |
Transcription is asynchronous. Poll the Get Recording endpoint to check when processing is complete.
Supported Audio Formats
| Format | Extension | Max Size |
|---|---|---|
| MP3 | .mp3 | 100 MB |
| WAV | .wav | 500 MB |
| M4A | .m4a | 100 MB |
| OGG | .ogg | 100 MB |
| FLAC | .flac | 500 MB |
| WebM | .webm | 100 MB |
Supported Languages
| Code | Language |
|---|---|
| en | English |
| es | Spanish |
| fr | French |
| de | German |
| it | Italian |
| pt | Portuguese |
| nl | Dutch |
| pl | Polish |
| ru | Russian |
| ja | Japanese |
| ko | Korean |
| zh | Chinese |
Errors
| Status | Error | Description |
|---|---|---|
| 400 | ”file is required” | No file was uploaded |
| 422 | ”Invalid file type” | Unsupported audio format |
| 422 | ”File too large” | File exceeds size limit |