---
title: "Get a show"
method: GET
path: "/shows/{show_id}"
tags: ["Shows"]
---

# Get a show

`GET /shows/{show_id}`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shows/{show_id}`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

Retrieve a show owned by the authenticated seller. Requires read:shows.

## Path parameters

- `show_id` string, uuid, required

## Response `200`

Successful Response

- Show
  - `id` string, required: The show's ID.
  - `title` string, required: The show's title.
  - `url` string, required: The url of the show in the seller's dashboard.
  - `description` string, nullable, required: The show's description, if set.
  - `status` 'scheduled' | 'live' | 'stopped' | 'ended' | 'cancelled', required
  - `visibility` 'public' | 'private', required
  - `scheduled_start_at` string, date-time, nullable, required: When the show is scheduled to start. Not updated when the show goes live.
  - `ended_at` string, date-time, nullable, required: When the show ended, if it has.
  - `thumbnail` Media, required
    - `id` string, nullable: The image's id.
    - `url` string, required: On create, the image URL to ingest. On read, the CDN URL of the ingested image.
    - `alt` string, nullable: The image's alt text / label, if set.
  - `created_at` string, date-time, required: Creation timestamp.
  - `updated_at` string, date-time, required: Last update timestamp.

## Other responses

- `404`: Show not found.
- `422`: Validation Error

---

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