> ## Documentation Index > Fetch the complete documentation index at: https://docs.chariot.in/llms.txt > Use this file to discover all available pages before exploring further. # List transcription history > List workspace transcription summaries across live, synchronous file and asynchronous batch inputs, newest first. ## OpenAPI ````yaml api-reference/openapi.json GET /v1/asr/history openapi: 3.1.0 info: title: Chariot API version: '1' description: >- Chariot is a voice AI platform built for Indian and English languages. Convert text into natural-sounding speech over a simple REST call, an HTTP audio stream, or a low-latency WebSocket, and transcribe speech to text over a streaming WebSocket or from a prerecorded file (Beta). This reference documents the public, API-key-authenticated endpoints. contact: name: Chariot Support email: support@chariot.in url: https://chariot.in servers: - url: https://api.chariot.in description: Production security: - APIKeyHeader: [] tags: - name: Text to Speech description: Convert text into speech synchronously or as a stream. - name: Speech to Text description: >- Transcribe prerecorded files (Beta) and review streaming speech-to-text sessions. - name: Voices description: Browse the voice catalog. - name: Account description: Inspect your credit balance and usage. paths: /v1/asr/history: get: tags: - Speech to Text summary: List transcription history description: >- **Beta.** List workspace transcription summaries across live, synchronous file and asynchronous batch inputs, newest first. Follow next_cursor until null. Retrieve text and word timings through GET /v1/asr/transcriptions/{transcription_id}. See the [Async transcription guide](/guides/speech-to-text/async-transcription). Summaries include a safe filename, public model_type, and transcript_preview of up to 240 characters. Retrieve the detail for the complete text. New live sessions report completed only after a final transcript, otherwise closed. operationId: listASRHistory parameters: - name: source in: query required: false schema: type: string enum: - live - file - name: execution in: query required: false schema: type: string enum: - realtime - sync - async - name: batch_id in: query required: false schema: type: string format: uuid - name: cursor in: query required: false schema: type: string maxLength: 512 - name: limit in: query required: false schema: type: integer default: 20 minimum: 1 maximum: 100 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/ASRAsyncTranscriptionHistory' '401': $ref: '#/components/responses/Unauthorized' '422': description: Invalid parameters or input. content: application/json: schema: $ref: '#/components/schemas/Error' security: - APIKeyHeader: [] components: schemas: ASRAsyncTranscriptionHistory: properties: items: items: $ref: '#/components/schemas/ASRAsyncTranscriptionSummary' title: Items type: array next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor required: - items - next_cursor title: TranscriptionHistory type: object Error: type: object description: Standard error envelope returned by all endpoints. properties: statusCode: type: integer description: HTTP status code, echoed in the body. error: type: string description: Machine-readable error class name. message: type: string description: Human-readable description of what went wrong. required: - statusCode - error - message ASRAsyncTranscriptionSummary: properties: model_type: anyOf: - type: string - type: 'null' title: Model Type filename: anyOf: - type: string - type: 'null' title: Filename input_audio: $ref: '#/components/schemas/ASRAsyncTranscriptionInputAudio' id: format: uuid title: Id type: string batch_id: anyOf: - type: string format: uuid - type: 'null' title: Batch Id custom_id: anyOf: - type: string - type: 'null' title: Custom Id source: enum: - live - file title: Source type: string execution: enum: - realtime - sync - async title: Execution type: string input_type: enum: - stream - upload - url title: Input Type type: string status: enum: - queued - processing - cancelling - completed - failed - cancelled - closed - unknown title: Status type: string created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At finished_at: anyOf: - type: string format: date-time - type: 'null' title: Finished At cancel_requested_at: anyOf: - type: string format: date-time - type: 'null' title: Cancel Requested At cancelled_at: anyOf: - type: string format: date-time - type: 'null' title: Cancelled At language: anyOf: - type: string - type: 'null' description: >- Caller-requested transcription language. none selects automatic language detection. Null means the historical setting was not recorded. title: Language mode: anyOf: - type: string - type: 'null' title: Mode style: anyOf: - type: string - type: 'null' title: Style include_timestamps: anyOf: - type: boolean - type: 'null' title: Include Timestamps duration_seconds: anyOf: - type: number - type: 'null' title: Duration Seconds progress: $ref: '#/components/schemas/ASRAsyncTranscriptionProgress' billing: $ref: '#/components/schemas/ASRAsyncTranscriptionBilling' error: anyOf: - $ref: '#/components/schemas/ASRAsyncTranscriptionError' - type: 'null' transcript_preview: anyOf: - type: string - type: 'null' description: >- First 240 characters for history listings only; fetch transcription detail for the complete result. title: Transcript Preview required: - model_type - filename - input_audio - id - batch_id - custom_id - source - execution - input_type - status - created_at - started_at - finished_at - cancel_requested_at - cancelled_at - language - mode - style - include_timestamps - duration_seconds - progress - billing - error - transcript_preview title: TranscriptionSummary type: object ASRAsyncTranscriptionInputAudio: properties: format: anyOf: - type: string - type: 'null' description: >- Original file container format, or live input encoding. Null when not recorded; never inferred from a filename. title: Format sample_rate_hz: anyOf: - exclusiveMinimum: 0 type: integer - type: 'null' description: >- Sample rate of the original audio track selected for transcription, before resampling. Null when not recorded. title: Sample Rate Hz required: - format - sample_rate_hz title: TranscriptionInputAudio type: object ASRAsyncTranscriptionProgress: properties: stage: title: Stage type: string stage_percent: anyOf: - maximum: 100 minimum: 0 type: number - type: 'null' description: >- Percentage within this stage only, never overall completion. Null when not measurable or terminal. title: Stage Percent updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At required: - stage - stage_percent - updated_at title: TranscriptionProgress type: object ASRAsyncTranscriptionBilling: properties: credits: anyOf: - type: integer - type: 'null' description: >- Current net credits debited for this transcription. Zero after a full refund; null when historical usage is unknown. title: Credits status: enum: - none - charged - settled - refunded - legacy title: Status type: string required: - credits - status title: TranscriptionBilling type: object ASRAsyncTranscriptionError: properties: code: description: >- Stable machine-readable failure code. Clients must tolerate new codes. title: Code type: string message: description: Safe human-readable explanation; do not branch on this text. title: Message type: string required: - code - message title: TranscriptionError type: object responses: Unauthorized: description: Authentication failed. The API key is missing, invalid, or expired. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: No credentials provided value: statusCode: 401 error: UnauthorizedException message: No API key or user credentials provided invalid: summary: Invalid or unknown API key value: statusCode: 401 error: UnauthorizedException message: Invalid API Key or user credentials securitySchemes: APIKeyHeader: type: apiKey in: header name: chariotai-api-key description: >- Your Chariot API key, generated from the dashboard. Send it in the `chariotai-api-key` header on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.