Get Voice File Job
Retrieve the current status and details of a Voice File Job.
- Poll this endpoint until status reaches
COMPLETEDorFAILED - Once completed, use the transcript and translation endpoints to retrieve results
Documentation: Polling strategy and status meanings
인증
API key in format {id}.{secret}.
The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.
List and search endpoints drop out-of-scope notes from the response without an
error. Single-note reads and their sub-resources return 404, the same response
as a deleted note. See What notes a system key reads.
경로 매개변수
The job ID returned from Create Voice File Job
응답
Job details
Represents a voice file processing job. Voice File Jobs handle the complete pipeline of audio transcription and optional translation.
Processing Pipeline:
- Job created (
CREATED) → Upload URI provided - File uploaded (
UPLOADED) → Ready for processing - Processing started (
PROCESSING) → STT and translation in progress - Processing complete (
COMPLETED) → Results available
Processing Time Estimates:
Unique job identifier (UUID format)
"b2d1ab32-3fe2-4201-b0b4-391abdbaa023"
Current job processing status:
CREATED: Job created, waiting for file uploadUPLOADED: File uploaded, waiting for processing to startPROCESSING: Transcription/translation in progressCOMPLETED: All processing finished, results availableFAILED: Processing failed (check errorMessage)
CREATED, UPLOADED, PROCESSING, COMPLETED, FAILED "PROCESSING"
Timestamp when file upload was completed. Null if not yet uploaded.
"2025-07-20T10:00:20Z"
Timestamp when processing started. Null if not yet started.
"2025-07-20T10:01:00Z"
Timestamp when processing completed. Null if still processing.
null
Error message if job failed. Null for successful jobs.
null