rtcStats API

List sessions

Returns existing stored sessions for the token account ordered by creation date (newest first), paginated by <code>limit</code> and <code>page</code>. All filters are optional. Different filters are AND-combined; multiple values within one filter are OR-combined.

get/v1.0/sessions

Request

  • Base URL: https://api.rtcstats.com
  • URL: https://api.rtcstats.com/v1.0/sessions
  • Auth: HTTP bearer

Query parameters

namestring[]

Filter sessions whose title contains ANY of these substrings

observationTypesstring[]

Filter sessions that contain ANY of these observation type strings (exact type name, e.g. turnNoConfig). Comma-separated. Only critical/high/medium observations are indexed (low/info are excluded). Up to 20 values.

observationTagsstring[]

Filter sessions whose observations carry ANY of these tags. Comma-separated. Valid tags: connectivity, security, audio, video, datachannel, outbound, inbound, peripheral, behavior, network, configuration, cpu, bug.

osstring

Filter sessions by operating system (exact match). Examples: macOS, Windows, Linux, Android, iPhone, iPad.

browserstring

Filter sessions by browser (exact match). Examples: Chrome, Safari, Firefox, Edge.

browserVersionstring

Filter sessions by major browser version (exact match, e.g. 142).

userIdstring

Filter sessions by the end-user identifier carried in the rtcstats JWT (summary metadata user).

conferenceIdstring

Filter sessions by the conference identifier carried in the rtcstats JWT (summary metadata conference).

sessionIdstring

Filter sessions by the session identifier carried in the rtcstats JWT (summary metadata session).

hasCriticalboolean

When true, only sessions with at least one critical-severity observation.

hasHighboolean

When true, only sessions with at least one high-severity observation.

hasMediumboolean

When true, only sessions with at least one medium-severity observation.

hasLowScoreboolean

When true, only sessions whose experience score is low (< 60).

hasMediumScoreboolean

When true, only sessions whose experience score is medium (60 to 79).

hasHighScoreboolean

When true, only sessions whose experience score is high (>= 80).

limitinteger

Sessions per page, 1 to 1000 (default 100).

pageinteger

1-based page number (default 1). A page past the end returns an empty <code>data</code>.

Response

Success

totalinteger required

Number of sessions in <code>data</code>.

totalCountinteger required

Number of sessions matching the filters, across all pages.

pageinteger required

Page returned.

limitinteger required

Page size applied.

totalPagesinteger required

<code>ceil(totalCount / limit)</code>, <code>0</code> when nothing matches.

hasMoreboolean required

<code>true</code> when a later page holds more sessions.

Changes

No recorded changes to this operation across all 1 revision of this API.