Skip to main content
GET
/
v1
/
external
/
voice-file
/
jobs
/
{jobId}
Get Voice File Job
curl --request GET \
  --url https://api.tiro.ooo/v1/external/voice-file/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "b2d1ab32-3fe2-4201-b0b4-391abdbaa023",
  "status": "PROCESSING",
  "fileUploadedAt": "2025-07-20T10:00:20Z",
  "processStartedAt": "2025-07-20T10:01:00Z",
  "processCompletedAt": null,
  "errorMessage": null
}

Authorizations

​
Authorization
string
header
required

API key in format {id}.{secret}

Path Parameters

​
jobId
string
required

The job ID returned from Create Voice File Job

Response

Job details

Represents a voice file processing job. Voice File Jobs handle the complete pipeline of audio transcription and optional translation.

Processing Pipeline:

  1. Job created (CREATED) → Upload URI provided
  2. File uploaded (UPLOADED) → Ready for processing
  3. Processing started (PROCESSING) → STT and translation in progress
  4. Processing complete (COMPLETED) → Results available

Processing Time Estimates:

File DurationTypical Time
< 5 minutes45-75 seconds
5-20 minutes1-3 minutes
20-60 minutes3-6 minutes
1-4 hours6-18 minutes
​
id
string
required

Unique job identifier (UUID format)

Example:

"b2d1ab32-3fe2-4201-b0b4-391abdbaa023"

​
status
enum<string>
required

Current job processing status:

  • CREATED: Job created, waiting for file upload
  • UPLOADED: File uploaded, waiting for processing to start
  • PROCESSING: Transcription/translation in progress
  • COMPLETED: All processing finished, results available
  • FAILED: Processing failed (check errorMessage)
Available options:
CREATED,
UPLOADED,
PROCESSING,
COMPLETED,
FAILED
Example:

"PROCESSING"

​
fileUploadedAt
string<date-time> | null

Timestamp when file upload was completed. Null if not yet uploaded.

Example:

"2025-07-20T10:00:20Z"

​
processStartedAt
string<date-time> | null

Timestamp when processing started. Null if not yet started.

Example:

"2025-07-20T10:01:00Z"

​
processCompletedAt
string<date-time> | null

Timestamp when processing completed. Null if still processing.

Example:

null

​
errorMessage
string | null

Error message if job failed. Null for successful jobs.

Example:

null