---
title: "Retrieve a widget token"
method: GET
path: "/v2/webrtc/tokens/{id}"
tags: ["Wavix Embeddable"]
---

# Retrieve a widget token

`GET /v2/webrtc/tokens/{id}`

## Request

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

Returns the Wavix Embeddable widget token identified by `id`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Returns the widget token.

- WebRTCToken: Represents a WebRTC token that authorizes the Wavix embeddable widget to register against a SIP trunk.
  - `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.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.

## Changes

- **2026-09-08** `6a89c962481c`: 1 info
  - added the non-success response with the status `400`

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v2/webrtc/tokens/:id/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)