Session records and voices
These HTTP endpoints return data for your organization.
Send Authorization: Bearer <Resia API key> with each request.
Use https://api.resia.ai as the base URL.
These read requests do not start a session or incur a session charge.
Endpoints
| Method and path | Result | API reference |
|---|---|---|
GET /v1/live/session-history |
Sessions that received input audio, newest first. A session that never received input audio is not listed; read it by its ID. | List your live sessions |
GET /v1/live/sessions/{session_id} |
One session. | Get one live session |
GET /v1/live/sessions/{session_id}/charge |
One session's charge. | Get what a live session costs |
GET /v1/live/sessions/{session_id}/content |
A stored stereo WAV recording. | Download a Fullplex session recording |
GET /v1/live/available-voices |
Voices for one provider. | List voices for a live session |
Parameters
| Endpoint | Parameter | Location | Required | Rule |
|---|---|---|---|---|
| All | Authorization |
Header | Yes | Bearer <Resia API key>. |
| All | X-Resia-Organization-Id |
Header | No | Resia staff only. Omit it for your own organization. |
| Session history | cursor |
Query | No | Use next_cursor from the previous page. |
| Session history | limit |
Query | No | Integer from 1 to 200. Default: 50. |
| Session detail, charge, content | session_id |
Path | Yes | The session identifier. |
| Available voices | provider |
Query | No | cartesia or fish. Default: cartesia. |
curl -sS "$RESIA_API_BASE/v1/live/session-history?limit=50" \
-H "Authorization: Bearer $RESIA_API_KEY"
The history response contains items and next_cursor.
Each item has the session fields below.
An empty next_cursor marks the last page.
Session fields
The history items and session detail share these fields.
| Field | Type | Meaning |
|---|---|---|
id |
string | Session identifier. |
voice |
string or null | Explicit voice as provider:id. Null when the session uses the default voice or has no stored voice. |
api_credential_id |
string or null | API credential that started the session. Null for a member's session. |
created_by_user_id |
string or null | Member who started the session. Null for an API credential's session. |
created_at |
date-time string | Session admission time. |
closed_at |
date-time string or null | Close time, or null while open. |
close_reason |
string or null | close_requested, expired, connection_lost, or unreported. Null while open. |
seconds |
nonnegative integer or null | Whole duration seconds, or null while open. |
recorded |
boolean or null | True for a complete stored recording; false for none; null if recording availability cannot be read. |
An unreported session has no close report before the timeout.
Its duration and charge use the latest usage report.
Without a usage report, it records zero seconds and no charge.
Charge fields
A nanocent is one billionth of one US cent.
The charge stays pending until finalized_at has a value.
| Field | Type | Meaning |
|---|---|---|
id |
string | Charge identifier. |
fullplex_session_id |
string | Session identifier. |
amount_in_nanocents |
nonnegative integer or null | Final charge in nanocents. Null while pending. |
finalized_at |
date-time string or null | Finalization time. Null while pending. |
created_at |
date-time string | Time when the pending charge was created. |
The balance and monthly spend show these charges rounded to whole cents. See Fullplex prices for session prices.
Download a recording
Start the session with store: true.
Wait until the session closes.
Use the session ID from session.started:
curl -sS "$RESIA_API_BASE/v1/live/sessions/$SESSION_ID/content" \
-H "Authorization: Bearer $RESIA_API_KEY" \
-o session.wav
A successful response has content type audio/wav.
The left channel contains input audio; the right channel contains output audio.
An incomplete or absent recording returns 404.
Voice fields
The response contains a voices array.
Each voice has these fields:
| Field | Type | Meaning |
|---|---|---|
id |
string | Provider voice identifier. |
provider |
string | Voice provider. For this endpoint: cartesia or fish. |
name |
string | Display name. |
description |
string or null | Description, when available. |
language |
string or null | Language code, such as en, when available. |
gender |
string | Male, Female, Neutral, or Unknown. Never null. |
For provider restrictions, see Voice selection.
The catalog lists public voices that your organization can use.
Select a voice through session.audio.output.voice as provider:id.
See Connect a live session.
HTTP errors
| Status | Applies to | Meaning |
|---|---|---|
401 |
All endpoints | Missing or invalid credentials. |
404 |
Session detail and charge | The session is unknown or belongs to another organization. |
404 |
Content | No complete stored recording exists for your organization and that session. |
422 |
All endpoints | Invalid parameters. The voice catalog uses invalid_request for an invalid provider. |
503 with unavailable |
History, detail, charge, content | Fullplex is disabled. Authentication runs before this check. |
429 |
Voice catalog | The provider rate limit prevents the request. |
502 |
Voice catalog | The provider request failed. |
503 |
Voice catalog | The provider is unavailable or not configured. |
See Errors for the HTTP error format.

