Get Job Status
curl --request GET \
--url https://api.vachana.ai/stt/v3/batch/jobs/{job_id} \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}"
headers = {"X-API-Key-ID": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key-ID': '<api-key>'}};
fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "COMPLETED",
"config": {
"model": "gnani-prisma-v2.5",
"mode": "transcribe",
"language_code": "en-IN",
"with_diarization": false,
"num_speakers": null,
"is_multi_channel": false
},
"progress": {
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"in_progress_files": 0,
"queued_files": 0,
"cancelled_files": 0
}
}Get Job Status
Get batch job status and progress counters.
GET
/
stt
/
v3
/
batch
/
jobs
/
{job_id}
Get Job Status
curl --request GET \
--url https://api.vachana.ai/stt/v3/batch/jobs/{job_id} \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}"
headers = {"X-API-Key-ID": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key-ID': '<api-key>'}};
fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "COMPLETED",
"config": {
"model": "gnani-prisma-v2.5",
"mode": "transcribe",
"language_code": "en-IN",
"with_diarization": false,
"num_speakers": null,
"is_multi_channel": false
},
"progress": {
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"in_progress_files": 0,
"queued_files": 0,
"cancelled_files": 0
}
}Overview
Get the current status and progress of a batch job. This response does not include transcript text. After a terminal status, call Get Job Files, thenGET each transcript_url.
Authentication
| Header | Required | Description |
|---|---|---|
X-API-Key-ID | Yes | Your Gnani Prisma v2.5 API key |
Path Parameters
string
required
Job ID returned by Create Job.
Polling guidance
| Status | Terminal | Next step |
|---|---|---|
COMPLETED | Yes | Call /files, then GET each transcript_url |
PARTIAL_FAILURE | Yes | Same — fetch successful files via /files |
FAILED | Yes | Inspect /files + error_message |
START_FAILED | Yes | Read cancel_reason |
CANCELLED | Yes | Done |
Example cURL
curl "https://api.vachana.ai/stt/v3/batch/jobs/019fa259-b084-71eb-94d7-ba4cdf2e64c6" \
-H "X-API-Key-ID: <YOUR_API_KEY>"
Response
Success (200)
{
"job_id": "019fa259-b084-71eb-94d7-ba4cdf2e64c6",
"status": "COMPLETED",
"config": {
"model": "gnani-prisma-v2.5",
"mode": "transcribe",
"language_code": "en-IN",
"with_diarization": false,
"num_speakers": null,
"is_multi_channel": false
},
"progress": {
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"in_progress_files": 0,
"queued_files": 0,
"cancelled_files": 0
},
"cancel_reason": null,
"created_at": "2026-07-27T06:53:34.750193Z",
"started_at": "2026-07-27T06:53:37.276061Z",
"completed_at": "2026-07-27T06:53:52.179794Z",
"cancelled_at": null,
"updated_at": "2026-07-27T06:53:52.179928Z"
}
Error responses
404 Job not found{
"error": "JOB_NOT_FOUND",
"message": "Job 01900000-0000-7000-8000-000000000000 not found"
}
Use Cases
- Polling until a job reaches a terminal status
- Checking progress counters for multi-file jobs
status=COMPLETED.Was this page helpful?