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.