---
title: "Get a secret"
method: GET
path: "/v2/sites/{site_id}/live/broadcast/secrets/{secret_id}/"
tags: ["broadcast live"]
---

# Get a secret

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

## Request

- Base URL: `https://api.jwplayer.com`
- URL: `https://api.jwplayer.com/v2/sites/{site_id}/live/broadcast/secrets/{secret_id}/`
- Auth: API key in header `Authorization`

Retrieve the details of a specific secret

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

## Path parameters

- `secret_id` string, required: Unique identifier for a resource
- `site_id` string, required: Unique identifier for a resource

## Response `200`

Success

- SecretObjectSchema: Schema object for a secret
  - `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`: Resource with ID supplied does not exist in account and object namespace
- `500`: Internal server error

## Changes

- **2026-11-03** `9fad6bd5872e`: 1 info
  - added the media type `application/json` for the response with the status `404`

[Operation history](https://skmtc.dev/jwplayer/apis/management-api-v2/changes/v2/sites/:site_id/live/broadcast/secrets/:secret_id/get.md)

---

[API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jwplayer/apis/management-api-v2/revisions/9fad6bd5872e?raw)