> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gnani.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Job Files
> List per-file results and transcript URLs for a batch job.
## 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:
1. Call this endpoint after the job is terminal (filter with `status=COMPLETED`)
2. `GET` each `transcript_url` (no API key — pre-signed URL)
3. 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
In **Try it**, paste a real `job_id` from [Create Job](/api/STTBatch/Create_Job) before clicking Send. Leaving the placeholder `{job_id}` in the URL returns `422`.
Job ID returned by [Create Job](/api/STTBatch/Create_Job). Replace with your own `job_id` before sending.
## Query Parameters
Filter by file status. Use `COMPLETED` for successful transcripts. Omit to include `FAILED` / `SKIPPED`.
Page size (1–100).
Pagination cursor from `pagination.next_cursor`.
## Example cURL
```bash theme={null}
curl --request GET \
--url 'https://api.vachana.ai/stt/v3/batch/jobs/019fa79e-81f9-7a8a-a446-6eff16ddec30/files?status=COMPLETED' \
--header 'X-API-Key-ID: '
```
Download transcript text:
```bash theme={null}
curl -L ""
```
## Response
### Success — completed file (`200`)
```json theme={null}
{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"data": [
{
"file_id": "6f5e3bcd-add2-479c-8883-a9c27b221f10",
"original_path": "customer_call.wav",
"status": "COMPLETED",
"duration_seconds": "6.01",
"transcript_url": "https://gnaniasraudios.s3.amazonaws.com/results/019fa79e-81f9-7a8a-a446-6eff16ddec30/6f5e3bcd-add2-479c-8883-a9c27b221f10.json?X-Amz-Expires=3600&...",
"error_message": null,
"created_at": "2026-07-28T07:26:50.926489Z",
"completed_at": "2026-07-28T07:27:24.513422Z"
}
],
"pagination": {
"has_more": false,
"next_cursor": null,
"total_count": 1
}
}
```
### transcript\_url JSON (live-verified)
```json theme={null}
{
"file_id": "6f5e3bcd-add2-479c-8883-a9c27b221f10",
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"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
},
{
"segment_id": 0,
"start_time": 0.71,
"end_time": 2.36,
"text": "how can i help you today",
"speaker_id": 2,
"confidence": null,
"language_detected": null,
"sentiment": null,
"emotion": null
},
{
"segment_id": 0,
"start_time": 2.36,
"end_time": 6.01,
"text": "i am calling about my recent order number 12345",
"speaker_id": 2,
"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-28T07:27:24Z"
}
```
### Failed file — empty / non-speech audio
```json theme={null}
{
"job_id": "019fa79b-a07a-7a3e-93bf-4ee73974dfa2",
"data": [
{
"file_id": "e0323a1c-86ee-4898-aee7-7455dfc1eb52",
"original_path": "customer_call.wav",
"status": "FAILED",
"duration_seconds": null,
"transcript_url": null,
"error_message": "Empty transcript after 3 retries",
"created_at": "2026-07-28T07:23:42.170454Z",
"completed_at": "2026-07-28T07:24:32.106034Z"
}
],
"pagination": {
"has_more": false,
"next_cursor": null,
"total_count": 1
}
}
```
### Skipped file — invalid public URL
```json theme={null}
{
"job_id": "019fa79c-ec88-770c-b498-371fc21fb40e",
"data": [
{
"file_id": "7539fecd-3090-4b62-9172-01c7019430d3",
"original_path": "https://cdn.example.com/audio/missing.wav",
"status": "SKIPPED",
"duration_seconds": null,
"transcript_url": null,
"error_message": "REQUEST_ERROR: [Errno -2] Name or service not known",
"created_at": "2026-07-28T07:27:27.650893Z",
"completed_at": null
}
],
"pagination": {
"has_more": false,
"next_cursor": null,
"total_count": 1
}
}
```
| 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 |
Pre-signed URL to transcript JSON. Expires in 1 hour. No API key required to download.
Present when `status` is `FAILED` or `SKIPPED`.
## Use Cases
* Fetching transcript download links after a job completes
* Inspecting failed / skipped files via `error_message`
## OpenAPI
````yaml STTBatch.yml GET /stt/v3/batch/jobs/{job_id}/files
openapi: 3.1.0
info:
title: Gnani Speech-to-Text Batch API
version: 3.0.0
description: >
Batch STT Jobs API for asynchronous transcription of long or multiple audio
files.
Authenticate every request with the `X-API-Key-ID` header.
servers:
- url: https://api.vachana.ai
description: Production
security:
- ApiKeyAuth: []
paths:
/stt/v3/batch/jobs/{job_id}/files:
get:
tags:
- Speech-to-Text (Batch)
summary: Get Job Files
description: >
List per-file results and transcript URLs. Returns URLs, not transcript
text.
Call after a terminal job status, then GET each transcript_url.
operationId: list_batch_job_files
parameters:
- $ref: '#/components/parameters/JobId'
- name: status
in: query
required: false
description: Filter by file status (e.g. COMPLETED)
schema:
type: string
example: COMPLETED
- name: limit
in: query
required: false
description: Page size (1–100)
schema:
type: integer
minimum: 1
maximum: 100
default: 50
example: 50
- name: cursor
in: query
required: false
description: Pagination cursor from pagination.next_cursor
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
example:
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
components:
parameters:
JobId:
name: job_id
in: path
required: true
description: >-
Job ID returned by Create Job. Paste the UUID from the Create Job
response.
schema:
type: string
default: 019fa854-1db0-7e45-a026-7a6b09ff6d7c
example: 019fa854-1db0-7e45-a026-7a6b09ff6d7c
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key-ID
description: Your Gnani Prisma v2.5 API key
````