Seating & Halls

Hall metadata and event-level seating plans — needed if you're building a custom seat-picker UI.

Method	Path	Purpose
GET	/peppered/hall	List all halls
GET	/peppered/hall/{hallId}	Get a specific hall
GET	/peppered/seating/{eventId}	Get the seating plan for an event

---

List halls

GET /v1/:client_name/peppered/hall

Response

200 OK — array of HallResource:

[
  {
    "hallId": 1,
    "hallName": "Bellevue Grote Zaal",
    "hallAddress": "Leidsekade 90",
    "hallZip": "1017 PN",
    "hallCity": "Amsterdam",
    "hallPhone": "020-5305301",
    "hallUrl": "https://theaterbellevue.nl"
  }
]

---

Get hall

GET /v1/:client_name/peppered/hall/{hallId}

Response

200 OK — a single HallResource.

---

Get seating plan for an event

GET /v1/:client_name/peppered/seating/{eventId}

Returns the full seating plan for a specific event: the hall layout, price levels (ranks), sections, and per-seat availability.

Response

200 OK — SeatPlanResource:

{
  "eventId": 95,
  "hallId": 1,
  "priceLevels": [
    { "priceId": "2ePdA8q3BN", "rankId": 42, "name": "Rang 1", "amount": 24.50 }
  ],
  "sections": [
    {
      "sectionId": 5,
      "sectionName": "Parket",
      "rows": [
        {
          "rowNr": 1,
          "seats": [
            { "seatId": "abc", "seatNr": 1, "rankId": 42, "available": true },
            { "seatId": "def", "seatNr": 2, "rankId": 42, "available": false }
          ]
        }
      ]
    }
  ],
  "available": 120
}

---

HallResource fields

Field	Type	Description
hallId	integer	Unique hall ID
hallName	string	Hall name
hallAddress	string	Street + number
hallZip	string	Postcode
hallCity	string	City
hallPhone	string	Contact phone
hallUrl	string	Hall website

SeatPlanResource fields

Field	Type	Description
eventId	integer	Event this plan belongs to
hallId	integer	Hall ID
priceLevels	array	Available price levels (ranks) with prices
sections	array	Nested layout — sections → rows → seats
available	integer	Total available seats

Seat fields

Each seat in a row includes:

Field	Type	Description
seatId	string	Unique seat ID
seatNr	integer	Seat number
rankId	integer	Which price level
available	boolean	Whether this seat can currently be sold

For events in halls without specific seating (general admission), the response may have a single section with no explicit seat data but an available count.

---

See also: Events · Cart