Skip to main content
Get waitlist entry

Authorizations

Authorization
string
header
required

API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.

Path Parameters

entryId
string
required

Response

Success

object
enum<string>
required
Available options:
waitlist_entry
id
string
required

Opaque, prefixed bkw_….

livemode
boolean
required
created
required
location_id
string
required
status
enum<string>
required
Available options:
waiting,
notified,
on_my_way,
seated,
removed_by_guest,
removed_by_venue,
expired_no_response
party_size
integer
required
position
integer | null
required

1-based place in the queue while the entry is active; null once it is seated, removed, or expired.

quoted_wait
object | null
required

The wait quoted when the party joined, refreshed when it is notified. Null when none could be quoted.

joined_at
string
required

ISO-8601 UTC instant.

notified_at
string | null
required

ISO-8601 UTC instant the table-ready text was sent.

booking_id
string | null
required

The walk-in booking created when the party was seated; read it with GET /bookings/{bookingId}.

channel
string
required

The channel the party joined on, e.g. api_partner, voice_ai, internal.

guest
object
required