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

Parameter	Type	Required	Description
`job_id`	string (UUID)	Yes	Job ID from Create Job

Polling guidance

Poll no faster than every 10 seconds
For large jobs (100+ files), prefer every 30 seconds
Stop when status is terminal

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) — in progress

{
  "job_id": "019fa259-b084-71eb-94d7-ba4cdf2e64c6",
  "status": "IN_PROGRESS",
  "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": 0,
    "failed_files": 0,
    "in_progress_files": 0,
    "queued_files": 1,
    "cancelled_files": 0
  },
  "cancel_reason": null,
  "created_at": "2026-07-27T06:53:34.750193Z",
  "started_at": "2026-07-27T06:53:37.276061Z",
  "completed_at": null,
  "cancelled_at": null,
  "updated_at": "2026-07-27T06:53:45.000000Z"
}

Success (200) — done

{
  "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"
}

Next steps

Call Get Job Files with status=COMPLETED, then download each transcript_url. Use the playground on the right to try this endpoint with your API key.

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) — in progress

Success (200) — done

Next steps

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path parameters

​Polling guidance

​Example cURL

​Response

​Success (200) — in progress

​Success (200) — done

​Next steps

Authorizations

Path Parameters

Response

Overview

Authentication

Path parameters

Polling guidance

Example cURL

Response

Success (200) — in progress

Success (200) — done

Next steps