Session history

Chariot saves every streaming session to your workspace: the final transcript, the settings it ran with, what it cost, and how it ended. Use the history endpoints to review transcripts and reconcile billing.

What is saved

Item	Details
Transcript	The final transcript. If the session ended without `transcript.done`, for example on an idle timeout, the text recognized up to that point.
Settings	`model_type`, `mode`, `style`, `language`, `audio_format`, and `sample_rate`.
Usage	`audio_seconds` sent and `credits` charged.
Outcome	The WebSocket `close_code`, plus `started_at` and `ended_at`.

A session appears in history shortly after it closes.

List sessions

GET /v1/asr/sessions returns sessions in your workspace, newest first.

integer

default:"0"

Number of sessions to skip, for pagination.

integer

default:"20"

Maximum number of sessions to return, from 1 to 100.

curl "https://api.chariot.in/v1/asr/sessions?limit=20" \
  -H "chariotai-api-key: YOUR_API_KEY"

{
  "total": 42,
  "items": [
    {
      "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."
    }
  ]
}

Field	Description
`total`	Number of sessions in the workspace.
`session_id`	The `session_id` from `session.started`.
`created_at`	When the session was saved to history.
`language`	The language hint, or `null` for automatic language detection.
`audio_seconds`	Seconds of audio sent.
`credits`	Credits charged for the session.
`transcript`	The transcript. Can be empty or `null` if no text was recognized.

Get a session

GET /v1/asr/sessions/{session_id} returns one session, including how it ended.

curl https://api.chariot.in/v1/asr/sessions/3f2c9a71-5b0e-4d7a-9c1e-8a4b6d2f0e13 \
  -H "chariotai-api-key: YOUR_API_KEY"

The response has every field from the list, plus:

Field	Description
`close_code`	How the session ended. See close codes.
`started_at`	When the session started.
`ended_at`	When the session ended.

A session that does not exist, or belongs to another workspace, returns 404.

Get started

Text to speech

Speech to text

Resources

What is saved

List sessions

Get a session

​What is saved

​List sessions

​Get a session

What is saved

List sessions

Get a session