WHwhatnot
Shows

List shows

List shows with the given status by scheduled start time, latest first by default; set reverse=false for earliest first. Shows without a scheduled start time are listed last. Requires read:shows.

get/shows

Request

  • Base URL
    https://api.whatnot.com/seller-api/rest/v2
  • URL
    https://api.whatnot.com/seller-api/rest/v2/shows
  • 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

Query parameters

status'scheduled' | 'live' | 'stopped' | 'ended' | 'cancelled'

Only list shows with this status. Defaults to scheduled.

limitinteger

Maximum results per page.

cursorstring nullable

Cursor from the previous page.

reverseboolean

Return descending order when true; ascending when false.

Response

Successful Response

next_cursorstring nullable required

Continuation cursor; null when there are no more results.

Example response

{
  "data": [
    {
      "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.