List billed realtime sessions
Changed onPer-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.
Request
- Base URL: https://realtimeavatar.ai/api
- URL: https://realtimeavatar.ai/api/v1/usage/sessions
- Auth: HTTP bearer
Query parameters
Start of the window. Defaults to 30 days before to; clamped to no earlier than 90 days before it.
End of the window. Defaults to now.
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.
Opaque cursor — pass the previous response's nextCursor verbatim. A null nextCursor means the last page.
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
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.
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
Changes
- info
added the new optional
headerrequest parameterX-RTA-Speech-Diagnostics - info
added the optional property
//to the response with the status
- info