---
title: "Get Share Token"
method: GET
path: "/v1/rooms/{room_sid}/share-tokens/{token_sid}"
tags: ["rooms"]
---

# Get Share Token

`GET /v1/rooms/{room_sid}/share-tokens/{token_sid}`

## Request

- Base URL: `https://api.prod-us.streem.cloud`
- URL: `https://api.prod-us.streem.cloud/v1/rooms/{room_sid}/share-tokens/{token_sid}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/streem/apis/streem-api/docs/v1/rooms/:room_sid/share-tokens/:token_sid/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a Share Token by `token_sid`

## Path parameters

- `room_sid` string, required
- `token_sid` string, required

## Response `default`

default response

- StreemApiGetRoomShareTokenResponse
  - `share_token` StreemApiRoomShareToken
    - `sid` string
    - `expires_at` string, date-time
    - `room_sid` string
    - `label` string
    - `usage_count` integer
    - `share_url` string

---

[API](https://skmtc.dev/streem/apis/streem-api.md) - [All operations](https://skmtc.dev/streem/apis/streem-api/llms.txt) - [OpenAPI document](https://skmtc.dev/streem/apis/streem-api/revisions/04250faebd19?raw)