WHwhatnot
Shows

Get a show

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

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

Path parameters

show_idstring uuid required

The show's ID.

Response

Successful Response

idstring required

The show's ID.

titlestring required

The show's title.

urlstring required

The url of the show in the seller's dashboard.

descriptionstring nullable required

The show's description, if set.

status'scheduled' | 'live' | 'stopped' | 'ended' | 'cancelled' required
visibility'public' | 'private' required
scheduled_start_atstring date-time nullable required

When the show is scheduled to start. Not updated when the show goes live.

ended_atstring date-time nullable required

When the show ended, if it has.

created_atstring date-time required

Creation timestamp.

updated_atstring date-time required

Last update timestamp.

Example response

{
  "created_at": "2026-09-20T18:30:00.000Z",
  "description": "Vintage and modern breaks, giveaways every 30 minutes.",
  "id": "0b6f3c1e-8a52-4d2e-9f7a-3c5d1e2f4a6b",
  "scheduled_start_at": "2026-09-27T01:00:00.000Z",
  "status": "scheduled",
  "thumbnail": {
    "id": "12345",
    "url": "https://images.whatnot.com/thumbnail.jpg"
  },
  "title": "Sunday Night Pokémon Breaks",
  "updated_at": "2026-09-21T09:15:00.000Z",
  "url": "https://www.whatnot.com/dashboard/lives/edit/0b6f3c1e-8a52-4d2e-9f7a-3c5d1e2f4a6b",
  "visibility": "public"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.