WHwhatnot
Merchandising

List a product's shows

List the upcoming or live shows the product is assigned to, by scheduled start time, latest first by default; set reverse=false for earliest first. Ended and cancelled shows are not listed. Only the product's 250 most recent show assignments are considered. Requires read:merchandising and read:shows.

get/merchandising/products/{product_id}/shows

Request

  • Base URL
    https://api.whatnot.com/seller-api/rest/v2
  • URL
    https://api.whatnot.com/seller-api/rest/v2/merchandising/products/{product_id}/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

Path parameters

product_idstring required

The product's ID.

Query parameters

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.