> ## 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. # Get ASR session > Return one streaming session with its transcript, settings, cost, and how it ended. ## OpenAPI ````yaml api-reference/openapi.json GET /v1/asr/sessions/{session_id} 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. 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: 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/sessions/{session_id}: get: tags: - Speech to Text summary: Get ASR session description: >- Return one streaming session with its transcript, settings, cost, and how it ended. operationId: getAsrSession parameters: - name: session_id in: path required: true description: The `session_id` from `session.started`. schema: type: string format: uuid responses: '200': description: The session. content: application/json: schema: $ref: '#/components/schemas/ASRSessionDetail' example: session_id: 3f2c9a71-5b0e-4d7a-9c1e-8a4b6d2f0e13 created_at: '2026-10-19T09:41:27.518000Z' model_type: chariot-1-asr-realtime mode: balanced style: codemix language: en audio_format: pcm_16000 sample_rate: 16000 audio_seconds: 4.82 credits: 8 transcript: Hi, I'd like to move the meeting to Thursday. close_code: 1000 started_at: '2026-10-19T09:41:21.904000Z' ended_at: '2026-10-19T09:41:27.402000Z' '401': $ref: '#/components/responses/Unauthorized' '404': description: No session with this id in your workspace. content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 404 error: HTTPException message: Session not found '422': $ref: '#/components/responses/ValidationError' components: schemas: ASRSessionDetail: allOf: - $ref: '#/components/schemas/ASRSessionSummary' - type: object properties: close_code: type: - integer - 'null' description: >- The WebSocket close code the session ended with, for example 1000 for a normal finish. started_at: type: string format: date-time description: When the session started. ended_at: type: string format: date-time description: When the session ended. 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 ASRSessionSummary: type: object description: One streaming session. properties: session_id: type: string format: uuid description: The `session_id` from `session.started`. created_at: type: string format: date-time description: When the session was saved to history. model_type: type: string examples: - chariot-1-asr-realtime mode: type: string enum: - balanced - high_accuracy style: type: string enum: - codemix - native language: type: - string - 'null' description: The language hint, or null for automatic language detection. examples: - en audio_format: type: string examples: - pcm_16000 sample_rate: type: integer description: Sample rate of the audio sent, in Hz. examples: - 16000 audio_seconds: type: number description: Seconds of audio sent. credits: type: integer description: Credits charged for the session. transcript: type: - string - 'null' description: >- The final transcript, or the text recognized before the session ended. Can be empty or null if no text was recognized. 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 ValidationError: description: >- The request failed validation. This includes malformed JSON, missing or wrongly typed fields, out-of-range values, and business-rule violations such as text length limits or a voice that is not ready for synthesis. content: application/json: schema: $ref: '#/components/schemas/Error' examples: text_too_long: summary: Text over the 500-character limit value: statusCode: 422 error: ValidationException message: >- Input text of length 812 is more than maximum character count of 500 characters! voice_not_ready: summary: Voice still processing value: statusCode: 422 error: ValidationException message: >- Voice 3acc7441-4dce-4245-a365-0bae822c8c30 is not ready for TTS yet! 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.