For the complete documentation index, see llms.txt. This page is also available as Markdown.

Attendee Addons

Attendee addon selection

List attendee addons

get

Returns all addon items for a specific attendee within an event. Each addon represents the attendee's selection of a ticket class add-on, including quantity and selection status.

Path parameters
eventIdstring · uuidRequired

Event UUID

attendeeIdstring · uuidRequired

Attendee UUID

Responses
200

Array of addon items belonging to the attendee

application/json

Attendee addon row — represents an attendee's selected addon item within an event

idstringRequiredExample: 550e8400-e29b-41d4-a716-446655440003
eventIdstringRequiredExample: aaff0556-85b5-4ac4-a484-486c7f319c08
claimedByAttendeeIdstring · nullableRequiredExample: 6daeaa1f-f82f-4068-a8b2-712894b00184
orderItemIdstring · nullableRequired
addOnIdstringRequiredExample: 473ed8f7-deae-4bee-bb32-eafd860aebe4
qtynumberRequiredExample: 1
selectionStatusstring · nullableRequiredExample: waitlisted
waitlistedAtstring · nullableRequiredExample: 2026-08-17T09:36:08.887Z
confirmedAtstring · nullableRequired
createdAtstring · nullableRequiredExample: 2026-08-17T08:28:35.518Z
updatedAtstring · nullableRequiredExample: 2026-08-17T09:36:09.620Z
get/v2/events/{eventId}/attendees/{attendeeId}/addons
GET /v2/events/{eventId}/attendees/{attendeeId}/addons HTTP/1.1
Host: api.eventx.io
Accept: */*
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440003",
    "eventId": "aaff0556-85b5-4ac4-a484-486c7f319c08",
    "claimedByAttendeeId": "6daeaa1f-f82f-4068-a8b2-712894b00184",
    "orderItemId": null,
    "addOnId": "473ed8f7-deae-4bee-bb32-eafd860aebe4",
    "qty": 1,
    "selectionStatus": "waitlisted",
    "waitlistedAt": "2026-08-17T09:36:08.887Z",
    "confirmedAt": null,
    "createdAt": "2026-08-17T08:28:35.518Z",
    "updatedAt": "2026-08-17T09:36:09.620Z"
  }
]

Create an attendee addon

post

Adds a new addon selection for an attendee. The addon is linked to a ticket class add-on ID and starts with a selection status (default: regular).

Path parameters
eventIdstring · uuidRequired

Event UUID

attendeeIdstring · uuidRequired

Attendee UUID

Body
addOnIdstring · uuidRequired

The ticket class add-on ID that this attendee has selected

Example: 473ed8f7-deae-4bee-bb32-eafd860aebe4
qtyinteger · min: 1Optional

Quantity of this addon selected

Default: 1Example: 1
selectionStatusstring · enumOptional

Initial selection status

Default: regularExample: regularPossible values:
Responses
201

Addon item created successfully

application/json

Attendee addon row — represents an attendee's selected addon item within an event

idstringRequiredExample: 550e8400-e29b-41d4-a716-446655440003
eventIdstringRequiredExample: aaff0556-85b5-4ac4-a484-486c7f319c08
claimedByAttendeeIdstring · nullableRequiredExample: 6daeaa1f-f82f-4068-a8b2-712894b00184
orderItemIdstring · nullableRequired
addOnIdstringRequiredExample: 473ed8f7-deae-4bee-bb32-eafd860aebe4
qtynumberRequiredExample: 1
selectionStatusstring · nullableRequiredExample: waitlisted
waitlistedAtstring · nullableRequiredExample: 2026-08-17T09:36:08.887Z
confirmedAtstring · nullableRequired
createdAtstring · nullableRequiredExample: 2026-08-17T08:28:35.518Z
updatedAtstring · nullableRequiredExample: 2026-08-17T09:36:09.620Z
post/v2/events/{eventId}/attendees/{attendeeId}/addons
POST /v2/events/{eventId}/attendees/{attendeeId}/addons HTTP/1.1
Host: api.eventx.io
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "addOnId": "473ed8f7-deae-4bee-bb32-eafd860aebe4",
  "qty": 1,
  "selectionStatus": "regular"
}
{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "eventId": "aaff0556-85b5-4ac4-a484-486c7f319c08",
  "claimedByAttendeeId": "6daeaa1f-f82f-4068-a8b2-712894b00184",
  "orderItemId": null,
  "addOnId": "473ed8f7-deae-4bee-bb32-eafd860aebe4",
  "qty": 1,
  "selectionStatus": "waitlisted",
  "waitlistedAt": "2026-08-17T09:36:08.887Z",
  "confirmedAt": null,
  "createdAt": "2026-08-17T08:28:35.518Z",
  "updatedAt": "2026-08-17T09:36:09.620Z"
}

Get attendee addon by ID

get

Returns a single addon item by its ID, scoped to a specific attendee and event.

Path parameters
eventIdstring · uuidRequired

Event UUID

attendeeIdstring · uuidRequired

Attendee UUID

addOnIdstring · uuidRequired

Addon item UUID

Responses
200

Addon item

application/json

Attendee addon row — represents an attendee's selected addon item within an event

idstringRequiredExample: 550e8400-e29b-41d4-a716-446655440003
eventIdstringRequiredExample: aaff0556-85b5-4ac4-a484-486c7f319c08
claimedByAttendeeIdstring · nullableRequiredExample: 6daeaa1f-f82f-4068-a8b2-712894b00184
orderItemIdstring · nullableRequired
addOnIdstringRequiredExample: 473ed8f7-deae-4bee-bb32-eafd860aebe4
qtynumberRequiredExample: 1
selectionStatusstring · nullableRequiredExample: waitlisted
waitlistedAtstring · nullableRequiredExample: 2026-08-17T09:36:08.887Z
confirmedAtstring · nullableRequired
createdAtstring · nullableRequiredExample: 2026-08-17T08:28:35.518Z
updatedAtstring · nullableRequiredExample: 2026-08-17T09:36:09.620Z
get/v2/events/{eventId}/attendees/{attendeeId}/addons/{addOnId}
GET /v2/events/{eventId}/attendees/{attendeeId}/addons/{addOnId} HTTP/1.1
Host: api.eventx.io
Accept: */*
{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "eventId": "aaff0556-85b5-4ac4-a484-486c7f319c08",
  "claimedByAttendeeId": "6daeaa1f-f82f-4068-a8b2-712894b00184",
  "orderItemId": null,
  "addOnId": "473ed8f7-deae-4bee-bb32-eafd860aebe4",
  "qty": 1,
  "selectionStatus": "waitlisted",
  "waitlistedAt": "2026-08-17T09:36:08.887Z",
  "confirmedAt": null,
  "createdAt": "2026-08-17T08:28:35.518Z",
  "updatedAt": "2026-08-17T09:36:09.620Z"
}

Update attendee addon

patch

Updates an attendee addon item. Accepts optional fields: selection_status (with transition validation), qty, and addOnId. At least one field must be provided. Valid status transitions: regular→waitlisted, waitlisted→confirmed, confirmed→waitlisted.

Path parameters
eventIdstring · uuidRequired

Event UUID

attendeeIdstring · uuidRequired

Attendee UUID

addOnIdstring · uuidRequired

Addon item UUID

Body
selection_statusstring · enumOptional

New selection status. Transitions: regular→waitlisted, waitlisted→confirmed, confirmed→waitlisted. See route description for status meanings.

Possible values:
qtyinteger · min: 1Optional

New quantity

addOnIdstring · uuidOptional

New add-on ID

Responses
200

Addon item updated successfully

application/json

Attendee addon row — represents an attendee's selected addon item within an event

idstringRequiredExample: 550e8400-e29b-41d4-a716-446655440003
eventIdstringRequiredExample: aaff0556-85b5-4ac4-a484-486c7f319c08
claimedByAttendeeIdstring · nullableRequiredExample: 6daeaa1f-f82f-4068-a8b2-712894b00184
orderItemIdstring · nullableRequired
addOnIdstringRequiredExample: 473ed8f7-deae-4bee-bb32-eafd860aebe4
qtynumberRequiredExample: 1
selectionStatusstring · nullableRequiredExample: waitlisted
waitlistedAtstring · nullableRequiredExample: 2026-08-17T09:36:08.887Z
confirmedAtstring · nullableRequired
createdAtstring · nullableRequiredExample: 2026-08-17T08:28:35.518Z
updatedAtstring · nullableRequiredExample: 2026-08-17T09:36:09.620Z
patch/v2/events/{eventId}/attendees/{attendeeId}/addons/{addOnId}
PATCH /v2/events/{eventId}/attendees/{attendeeId}/addons/{addOnId} HTTP/1.1
Host: api.eventx.io
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "selection_status": "confirmed",
  "qty": 1,
  "addOnId": "123e4567-e89b-12d3-a456-426614174000"
}
{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "eventId": "aaff0556-85b5-4ac4-a484-486c7f319c08",
  "claimedByAttendeeId": "6daeaa1f-f82f-4068-a8b2-712894b00184",
  "orderItemId": null,
  "addOnId": "473ed8f7-deae-4bee-bb32-eafd860aebe4",
  "qty": 1,
  "selectionStatus": "waitlisted",
  "waitlistedAt": "2026-08-17T09:36:08.887Z",
  "confirmedAt": null,
  "createdAt": "2026-08-17T08:28:35.518Z",
  "updatedAt": "2026-08-17T09:36:09.620Z"
}

Last updated