---
title: "List Share Tokens"
method: GET
path: "/v1/rooms/{room_sid}/share-tokens"
tags: ["rooms"]
---

# List Share Tokens

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

List Share Tokens for this Room, which give readonly access to the Assets of the Room

## Path parameters

- `room_sid` string, required

## Query parameters

- `include_expired` boolean
- `expires` 'EXPIRES_ANY' | 'EXPIRES_NO' | 'EXPIRES_YES'
- `view` 'VIEW_BASIC' | 'VIEW_FULL' | 'VIEW_INVALID'
- `page_size` integer
- `page_token` string

## Response `default`

default response

- StreemApiListRoomShareTokensResponse
  - `share_tokens` StreemApiRoomShareToken[]
    - `sid` string
    - `expires_at` string, date-time
    - `room_sid` string
    - `label` string
    - `usage_count` integer
    - `share_url` string
  - `next_page_token` string
  - `total_size` integer

---

[API](https://skmtc.net/streem/apis/streem-api.md) · [All operations](https://skmtc.net/streem/apis/streem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streem/streem-api/revisions/04250faebd19/schema)