Usage

List billed realtime sessions

Changed on

Per-second billable detail. The window defaults to the trailing 30 days and is CLAMPED to 90 — a wider range is served narrowed, not refused, so read back the returned from/to.

Requires an API key with the usage:read scope.

get/v1/usage/sessions

Request

  • Base URL: https://realtimeavatar.ai/api
  • URL: https://realtimeavatar.ai/api/v1/usage/sessions
  • Auth: HTTP bearer

Query parameters

fromstring date-time

Start of the window. Defaults to 30 days before to; clamped to no earlier than 90 days before it.

tostring date-time

End of the window. Defaults to now.

limitinteger

Rows per page. Defaults to 50, clamped to 1–200; with X-RTA-Speech-Diagnostics: 1 clamped to 1–50. Read the actual returned rows and nextCursor.

cursorstring

Opaque cursor — pass the previous response's nextCursor verbatim. A null nextCursor means the last page.

endUserIdstring

Narrow to one of YOUR users — matches the client_metadata.user_id the call was minted with. Untagged calls still return, with empty metadata.

Headers

X-RTA-Release-Evidence'1'

Send 1 to include optional session-bound releaseIdentity in this response. Without this opt-in the field is omitted for strict client compatibility. Capture and storage are independent of this header; missing evidence remains null. Older servers may ignore this header.

X-RTA-Speech-Diagnostics'1'

Send exactly 1 to include numeric closed dialogue speechDiagnostics. Otherwise omitted and no summary reads occur. Opt-in pages clamp to 50 rows with normal keyset pagination; each row has explicit availability. Whole-session cohorts, not query-time slices or pooled turn percentiles. Summary budget 65536 bytes, total page deadline 5000 ms, concurrency 4. Older servers may ignore this header.

Response

Sessions

nextCursorstring nullable required
fromstring date-time required
tostring date-time required

Changes

    • info

      added the new optional header request parameter X-RTA-Speech-Diagnostics

    • info

      added the optional property // to the response with the status