Get Job Files

curl --request GET \
  --url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/files \
  --header 'X-API-Key-ID: <api-key>'

import requests

url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/files"

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}/files', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
  "data": [
    {
      "file_id": "a5708e96-7a28-4c01-8b07-2fe606fa9785",
      "original_path": "customer_call.wav",
      "status": "COMPLETED",
      "duration_seconds": "6.01",
      "transcript_url": "https://example-presigned-url.example/transcript.json",
      "error_message": null
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 1
  }
}

GET

stt

batch

jobs

{job_id}

files

Get Job Files

curl --request GET \
  --url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/files \
  --header 'X-API-Key-ID: <api-key>'

import requests

url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/files"

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}/files', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
  "data": [
    {
      "file_id": "a5708e96-7a28-4c01-8b07-2fe606fa9785",
      "original_path": "customer_call.wav",
      "status": "COMPLETED",
      "duration_seconds": "6.01",
      "transcript_url": "https://example-presigned-url.example/transcript.json",
      "error_message": null
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 1
  }
}

Overview

List per-file results for a job. For completed files, this returns transcript_url — not the transcript text. To get full_transcript (without webhooks):

Call this endpoint after the job is terminal (filter with status=COMPLETED)
GET each transcript_url (no API key — pre-signed URL)
Read full_transcript from the JSON

transcript_url expires in 1 hour. Re-call this endpoint for a fresh 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

Query parameters

Parameter	Type	Default	Description
`status`	string	—	e.g. `COMPLETED`
`limit`	integer	`50`	Page size (1–100)
`cursor`	string	—	Pagination cursor

Example cURL

curl "https://api.vachana.ai/stt/v3/batch/jobs/019fa259-b084-71eb-94d7-ba4cdf2e64c6/files?status=COMPLETED" \
  -H "X-API-Key-ID: <YOUR_API_KEY>"

Download transcript text

curl -L "<transcript_url_from_response>"

Response

Success (200) — file list

{
  "job_id": "019fa259-b084-71eb-94d7-ba4cdf2e64c6",
  "data": [
    {
      "file_id": "28255118-03ca-48c5-807e-8d07a6f54d54",
      "original_path": "customer_call.wav",
      "status": "COMPLETED",
      "duration_seconds": "6.01",
      "transcript_url": "https://gnaniasraudios.s3.amazonaws.com/results/.../28255118-03ca-48c5-807e-8d07a6f54d54.json?X-Amz-Expires=3600&...",
      "error_message": null,
      "created_at": "2026-07-27T06:53:34.750193Z",
      "completed_at": "2026-07-27T06:53:52.128197Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "total_count": 1
  }
}

Transcript_url JSON

{
  "file_id": "28255118-03ca-48c5-807e-8d07a6f54d54",
  "job_id": "019fa259-b084-71eb-94d7-ba4cdf2e64c6",
  "original_path": "customer_call.wav",
  "language_code": "en-IN",
  "duration_seconds": 6.01,
  "model": "gnani-prisma-v2.5",
  "mode": "transcribe",
  "segments": [
    {
      "segment_id": 0,
      "start_time": 0.0,
      "end_time": 0.71,
      "text": "hello",
      "speaker_id": 1,
      "confidence": null,
      "language_detected": null,
      "sentiment": null,
      "emotion": null
    }
  ],
  "full_transcript": "hello how can i help you today i am calling about my recent order number 12345",
  "created_at": "2026-07-27T06:53:52Z"
}

File status	Meaning
`COMPLETED`	Done — `transcript_url` available
`FAILED`	Failed — see `error_message`
`SKIPPED`	Not processed (bad URL / format / access)
`CANCELLED`	Skipped due to job cancel

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.

Query Parameters

status

string

Filter by file status (e.g. COMPLETED)

limit

integer

default:50

Page size (1–100)

Required range: 1 <= x <= 100

cursor

string

Pagination cursor from pagination.next_cursor

Response

200 - application/json

The response is of type object.

Gnani APIs

APIs

Use Cases

Get Job Files

Overview

Authentication

Path parameters

Query parameters

Example cURL

Download transcript text

Response

Success (200) — file list

Transcript_url JSON

Authorizations

Path Parameters

Query Parameters

Response

​Overview

​Authentication

​Path parameters

​Query parameters

​Example cURL

​Download transcript text

​Response

​Success (200) — file list

​Transcript_url JSON

Authorizations

Path Parameters

Query Parameters

Response

Overview

Authentication

Path parameters

Query parameters

Example cURL

Download transcript text

Response

Success (200) — file list

Transcript_url JSON