---
title: "List secrets"
method: GET
path: "/v2/sites/{site_id}/live/broadcast/secrets/"
tags: ["broadcast live"]
---

# List secrets

`GET /v2/sites/{site_id}/live/broadcast/secrets/`

List all secrets for a site

Each secret represents a passphrase or key used for securing live streams.

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Query parameters

- `page` integer
- `page_length` integer
- `q` string
- `sort` string

## Response `200`

Success

- SecretCollectionSchema — Schema object for a collection of secrets
  - `page` integer — Offset for returned resources
  - `page_length` integer — Maximum number of resources to return
  - `total` integer — Number of resources available before pagination
  - `secrets` SecretObjectSchema[] — Array of all secrets for a site
    - `schema` string
    - `id` string — Unique identifier for a resource
    - `created` string — Date and time at which the resource was created
    - `last_modified` string — Date and time at which the resource was most recently modified
    - `type` string — Name of the type of resource.
    - `relationships` object — Ancilliary resources associated to the primary resource being read
    - `name` string — The friendly name for the secret
    - `lifespan` 'persistent' | 'single_use' — The lifespan of the secret determining deletion behavior

## Other responses

- `404` — Not Found The requested asset could not be found.
- `500` — Internal server error

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)