---
title: "List widget tokens"
method: GET
path: "/v2/webrtc/tokens"
tags: ["Wavix Embeddable"]
---

# List widget tokens

`GET /v2/webrtc/tokens`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v2/webrtc/tokens`
- Auth: HTTP bearer

Returns a paginated list of Wavix Embeddable widget tokens for the authenticated account.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of widget tokens.

- WebRTCTokensListResponse: Paginated list of WebRTC tokens.
  - `items` WebRTCToken[]: WebRTC tokens on the current page.
    - `uuid` string, required: Unique identifier of the WebRTC token.
    - `sip_trunk` string, required: Name of the SIP trunk the token authenticates against.
    - `payload` object, nullable: Arbitrary client-defined data associated with the token.
    - `ttl` integer, nullable: Time to live, in seconds. `null` means no expiration.
  - `pagination` Pagination
    - `current_page` integer, required: Current page number.
    - `per_page` integer, required: Number of records per page.
    - `total` integer, required: Total number of records.
    - `total_pages` integer, required: Total number of pages.

## Other responses

- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.

## Changes

- **2026-09-08** `6a89c962481c`: 2 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
- **2026-06-15** `76b9bb35619f`: 1 info
  - added the optional property `error` to the response with the `401` status
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 1 info
  - api operation id `GetActiveWidgetTokens` removed and replaced with `webrtc_tokens_list`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v2/webrtc/tokens/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)