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

stt

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, then GET 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

Poll no faster than every 10 seconds. For 100+ file jobs, prefer every 30 seconds.

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

Next: call Get Job Files with status=COMPLETED.

Authorizations

X-API-Key-ID

string

header

required

Your Gnani Prisma v2.5 API key

Path Parameters

job_id

string

default:019fa854-1db0-7e45-a026-7a6b09ff6d7c

required

Job ID returned by Create Job. Paste the UUID from the Create Job response.

Response

200 - application/json

The response is of type object.

Gnani APIs

APIs

Use Cases

Get Job Status

Overview

Authentication

Path Parameters

Polling guidance

Example cURL

Response

Success (200)

Error responses

Use Cases

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path Parameters

​Polling guidance

​Example cURL

​Response

​Success (200)

​Error responses

​Use Cases

Authorizations

Path Parameters

Response

Overview

Authentication

Path Parameters

Polling guidance

Example cURL

Response

Success (200)

Error responses

Use Cases