Skip to main content
POST
/
api
/
public
/
events
/
{id}
/
joinWaitingList
Join Event Waiting List
curl --request POST \
  --url https://spaces.nexudus.com/api/public/events/{id}/joinWaitingList \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "FullName": "<string>",
  "Email": "<string>"
}
'
{
  "401 Unauthorized": {},
  "404 Not Found": {},
  "400 Bad Request": {}
}

​
Join Event Waiting List

Registers the authenticated customer on the waiting list for an event that has no available tickets. When a spot becomes available, the operator can notify waiting-list members. Only callable when CalendarEvent.EnableWaitList is true and the event is sold out.

​
Authentication

Requires a valid customer bearer token.

​
Path Parameters

​
id
number
required
The integer ID of the event. Obtained as Id from GET /api/public/events or GET /api/public/events/{id}.

​
Request Body

The request body accepts the customer’s waiting-list registration data. The exact fields depend on the event configuration; pass an empty object {} if no additional fields are required.
​
FullName
string
Full name of the customer registering for the waiting list.
​
Email
string
Email address to notify when a spot becomes available.

​
Response

Returns an empty 200 OK on success.

​
Examples

​
Join the waiting list

POST /api/public/events/412/joinWaitingList
Authorization: Bearer {token}
Content-Type: application/json

{
  "FullName": "Alex Johnson",
  "Email": "alex@example.com"
}

HTTP/1.1 200 OK

​
TypeScript Integration

import endpoints from '@/api/endpoints'

await httpClient.post(endpoints.events.joinWaitingList(412), {
  FullName: 'Alex Johnson',
  Email: 'alex@example.com',
})

​
Usage in Portal

ContextSource file
Event detail page — waiting list form (/events/{id})src/views/events/details/data.ts
Waiting list form componentsrc/views/events/details/components/EventWaitingListForm.tsx

​
Error Responses

​
401 Unauthorized
error
The customer is not authenticated or the session has expired.
​
404 Not Found
error
No event with the specified ID exists.
​
400 Bad Request
error
The event does not have waiting list enabled (EnableWaitList is false), or the customer is already on the waiting list.
MethodEndpointDescription
GET/api/public/events/{id}Full event detail including EnableWaitList flag
GET/api/public/eventsPaginated list of published events
GET/api/public/events/myTickets held by the authenticated customer
GET/api/public/events/{eventId}/product/{productId}Ticket product availability detail