List Jobs
curl --request GET \
--url https://api.vachana.ai/stt/v3/batch/jobs \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "COMPLETED",
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"created_at": "2026-07-28T07:26:50.926489Z",
"completed_at": "2026-07-28T07:27:24.621462Z"
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJjcmVhdGVkX2F0IjogIjIwMjYtMDctMjdUMDc6NDM6NTguMDU1NzMzKzAwOjAwIiwgImlkIjogIjAxOWZhMjg3LWNmNjItNzE2OC1iM2MyLTQ1ZjExOGFjNzYxZCJ9"
}
}Batch transcription
List jobs
List batch transcription jobs with optional status filter and pagination.
GET
/
stt
/
v3
/
batch
/
jobs
List Jobs
curl --request GET \
--url https://api.vachana.ai/stt/v3/batch/jobs \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "COMPLETED",
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"created_at": "2026-07-28T07:26:50.926489Z",
"completed_at": "2026-07-28T07:27:24.621462Z"
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJjcmVhdGVkX2F0IjogIjIwMjYtMDctMjdUMDc6NDM6NTguMDU1NzMzKzAwOjAwIiwgImlkIjogIjAxOWZhMjg3LWNmNjItNzE2OC1iM2MyLTQ1ZjExOGFjNzYxZCJ9"
}
}Overview
Part of Batch transcription, which covers the whole flow, models, languages and limits. List batch jobs for your organization. Use filters and cursor pagination to browse history.Authentication
| Header | Required | Description |
|---|---|---|
X-API-Key-ID | Yes | Your Gnani API key |
Query parameters
string
Return only jobs with this status. Each value is described in Job statuses.
| Value | Meaning |
|---|---|
CREATED | Waiting for /start |
STARTING | Setup running |
QUEUED | Files queued |
IN_PROGRESS | Transcription running |
COMPLETED | All files succeeded |
PARTIAL_FAILURE | Mixed results |
FAILED | Failed |
START_FAILED | Setup failed |
CANCELLING | Cancel in progress |
CANCELLED | Cancelled |
integer
default:"20"
Page size (1–100).
string
Pagination cursor from
pagination.next_cursor.Example cURL
curl --request GET \
--url 'https://api.vachana.ai/stt/v3/batch/jobs?limit=3' \
--header 'X-API-Key-ID: <YOUR_API_KEY>'
Example — Python SDK
list_jobs() follows cursor pagination for you.
from gnani.stt import GnaniSTTBatchClient
client = GnaniSTTBatchClient()
for job in client.list_jobs(status="COMPLETED", limit=20):
print(job.id, job.status, job.completed_files, "/", job.total_files)
limit is the page size (1–100). Async: async for job in AsyncGnaniSTTBatchClient().list_jobs(): .... See the Python SDK.
Response
Success (200)
{
"data": [
{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "COMPLETED",
"total_files": 1,
"completed_files": 1,
"failed_files": 0,
"created_at": "2026-07-28T07:26:50.926489Z",
"completed_at": "2026-07-28T07:27:24.621462Z"
},
{
"job_id": "019fa79b-a07a-7a3e-93bf-4ee73974dfa2",
"status": "FAILED",
"total_files": 1,
"completed_files": 0,
"failed_files": 1,
"created_at": "2026-07-28T07:23:42.170454Z",
"completed_at": "2026-07-28T07:24:32.176627Z"
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJjcmVhdGVkX2F0IjogIjIwMjYtMDctMjdUMDc6NDM6NTguMDU1NzMzKzAwOjAwIiwgImlkIjogIjAxOWZhMjg3LWNmNjItNzE2OC1iM2MyLTQ1ZjExOGFjNzYxZCJ9"
}
}
array
List of jobs with status and file counters.
integer
Total files known for the job. May be
0 while still in CREATED.boolean
Whether another page exists.
string
Pass as
cursor on the next request.Use cases
- Reviewing recent batch jobs in your org
- Filtering failed or in-progress jobs for ops dashboards
Authorizations
Your Gnani API key
Query Parameters
Filter by job status (CREATED, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, etc.)
Page size (1–100)
Required range:
1 <= x <= 100Pagination cursor from pagination.next_cursor
Response
200 - application/json
OK
The response is of type object.
Was this page helpful?