---
title: "Fetch a Session's waitlist"
method: GET
path: "/shop/sessions/{sessionId}/waitlist"
tags: ["Sessions"]
---

# Fetch a Session's waitlist

`GET /shop/sessions/{sessionId}/waitlist`

Returns a support/admin-facing view of a `Session`'s waitlist: who
is currently queued (in order), who has already been promoted off
the waitlist, and the waitlist-related entries from the session
log — so "why did X get in ahead of Y?" can be answered without a
database query.

Requires the `RESERVATIONS_VIEW` permission on the session's site.

## Response `200`

The session's waitlist was successfully retrieved.

- object
  - `data` SessionWaitlist, required — A support/admin-facing view of a `Session`'s waitlist, its current queue, recent promotions off the waitlist, and related session-log entries.
    - `session_id` string, object-id, required — The `Session` id this waitlist belongs to.
    - `capacity` integer, required — The total capacity of the session.
    - `num_booked` integer, required — The total number of customers currently booked onto the session, regardless of checkout status.
    - `remaining_capacity` integer, required — The remaining capacity of the session.
    - `waitlist_enabled` boolean, required — Whether the waitlist is currently available for this session.
    - `num_waitlisted` integer, required — The number of customers currently on the waiting list for this session.
    - `waitlist` SessionWaitlistEntry[], required — Bookings currently on the waitlist, ordered oldest first — queue position 1 is next to be promoted.
      - `position` integer, required — The booking's 1-based position in the waitlist queue.
      - `booking_id` string, object-id, required — The id of the waitlisted `SessionBooking`.
      - `order_ref` string, nullable, required — The order reference of the basket the booking belongs to.
      - `name` string, nullable, required — The customer's full name, as recorded on the basket.
      - `num_customers` integer, required — The number of customers in this booking. Minimum 1.
      - `waitlisted_at` string, date-time, nullable, required — The date and time the booking joined the waitlist.
    - `promotions` SessionWaitlistPromotion[], required — Bookings that were previously on the waitlist and have since been promoted (confirmed), ordered oldest promotion first.
      - `booking_id` string, object-id, required — The id of the promoted `SessionBooking`.
      - `order_ref` string, nullable, required — The order reference of the basket the booking belongs to.
      - `name` string, nullable, required — The customer's full name, as recorded on the basket.
      - `waitlisted_at` string, date-time, nullable, required — The date and time the booking joined the waitlist.
      - `promoted_at` string, date-time, nullable, required — The date and time the booking was promoted (confirmed) off the waitlist.
    - `logs` SessionWaitlistLogEntry[], required — Waitlist-related entries from the session's activity log.
      - `level` string, required — The log entry's severity level.
      - `message` string, required — The log entry's message.
      - `timestamp` string, date-time, nullable, required — The date and time the log entry was recorded.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)