Guest Requests

List guest requests

GET/v1/teams/{teamId}/days/{dayId}/events/{eventId}/guest-requests

Lists guest request records for an event.

Required scopes: guest_request:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

Response 200

`data`	`object[]`
`data[].dayId`	`string:uuid` Day identifier that owns the event for this guest request.
`data[].eventId`	`string:uuid` Event identifier that owns this guest request.
`data[].guestFirstName`	`string` Guest's first name.
`data[].guestLastName`	`string` Guest's last name.
`data[].totalTickets`	`integer` Total number of tickets requested for the guest.
`data[].status`	`"pending" \| "approved" \| "denied"` Current approval status for the guest request.
`data[].pickupLocation`	`"will_call" \| "in_hand" \| "other"` Where the guest should receive or pick up their tickets.
`data[].attendeeContactEmail`	`string:email` Optional email address for the guest or attendee contact.
`data[].notes`	`string` Internal notes for this guest request.
`data[].ticketType`	`object` Optional ticket type snapshot requested for the guest.
`data[].ticketType.ticketTypeId`	`string:uuid` Ticket type identifier requested for this guest.
`data[].ticketType.nameAtRequest`	`string` Ticket type display name captured when the guest request was created or updated.
`data[].ticketType.abbreviationAtRequest`	`string` Short ticket type label captured when the guest request was created or updated.
`data[].passes`	`object[]` Pass type requests associated with this guest request.
`data[].passes[].passTypeId`	`string:uuid` Pass type identifier requested for this guest.
`data[].passes[].nameAtRequest`	`string` Pass type display name captured when the guest request was created or updated.
`data[].passes[].abbreviationAtRequest`	`string` Short pass type label captured when the guest request was created or updated.
`data[].passes[].quantity`	`integer` Number of passes requested for this pass type.
`data[].assignedSeats`	`object[]` Seat assignments attached after the guest request is fulfilled.
`data[].assignedSeats[].id`	`string:uuid` Assigned seat identifier.
`data[].assignedSeats[].section`	`string` Venue seating section label.
`data[].assignedSeats[].row`	`string` Venue seating row label.
`data[].assignedSeats[].seat`	`string` Venue seating seat label.
`data[].assignedSeats[].ticketTypeId`	`string:uuid` Ticket type identifier associated with this assigned seat.
`data[].id`	`string:uuid` Guest request identifier.
`data[].orgId`	`string:uuid` Team identifier that owns this guest request.
`data[].isDeleted`	`boolean` Whether the guest request has been deleted.
`data[].createdBy`	`string:uuid \| string` User identifier that created the guest request.
`data[].createdByName`	`string` Display name captured for the creator.
`data[].createdAt`	`string:date-time` ISO 8601 timestamp when the request was created.
`data[].updatedAt`	`string:date-time` ISO 8601 timestamp when the request was last updated.
`data[].version`	`integer` Current guest request aggregate version.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this guest request record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: List guest requests

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000801",
      "guestFirstName": "Jamie",
      "guestLastName": "Lee",
      "totalTickets": 2,
      "status": "pending",
      "pickupLocation": "will_call",
      "attendeeContactEmail": "jamie@example.com",
      "notes": "Guest of tour manager.",
      "ticketType": {
        "ticketTypeId": "00000000-0000-4000-8000-000000000961",
        "nameAtRequest": "Reserved",
        "abbreviationAtRequest": "RSV"
      },
      "passes": [
        {
          "passTypeId": "00000000-0000-4000-8000-000000000951",
          "nameAtRequest": "All Access",
          "abbreviationAtRequest": "AA",
          "quantity": 2
        }
      ],
      "assignedSeats": [],
      "dayId": "00000000-0000-4000-8000-000000000201",
      "eventId": "00000000-0000-4000-8000-000000000601",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "isDeleted": false,
      "createdBy": "00000000-0000-4000-8000-000000000101",
      "createdByName": "Jamie Lee",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedAt": "2026-09-01T12:00:00.000Z",
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Create a guest request

POST/v1/teams/{teamId}/days/{dayId}/events/{eventId}/guest-requests

Accepts a command to create a guest request for an event.

Required scopes: guest_request:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`guestFirstName`required	`string` Guest's first name.
`guestLastName`required	`string` Guest's last name.
`totalTickets`required	`integer` Total number of tickets requested for the guest.
`status`required	`"pending" \| "approved" \| "denied"` Current approval status for the guest request.
`pickupLocation`required	`"will_call" \| "in_hand" \| "other"` Where the guest should receive or pick up their tickets.
`attendeeContactEmail`	`string:email` Optional email address for the guest or attendee contact.
`notes`	`string` Internal notes for this guest request.
`assignedSeats`required	`object[]` Seat assignments attached after the guest request is fulfilled.
`assignedSeats[].id`required	`string:uuid` Assigned seat identifier.
`assignedSeats[].section`required	`string` Venue seating section label.
`assignedSeats[].row`required	`string` Venue seating row label.
`assignedSeats[].seat`required	`string` Venue seating seat label.
`assignedSeats[].ticketTypeId`	`string:uuid` Ticket type identifier associated with this assigned seat.
`id`	`string:uuid` Optional caller-supplied guest request ID. RoadOps generates one when omitted.
`requestedByUserId`	`string:uuid` Optional member ID to create the request on behalf of.
`requestedByName`	`string` Optional display name for the requested-by member.
`ticketType`	`object` Optional ticket type requested for the guest.
`ticketType.ticketTypeId`required	`string:uuid` Ticket type identifier requested for this guest.
`passes`required	`object[]` Pass type requests associated with this guest request.
`passes[].passTypeId`required	`string:uuid` Pass type identifier requested for this guest.
`passes[].quantity`required	`integer` Number of passes requested for this pass type.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create guest request

{
  "id": "00000000-0000-4000-8000-000000000801",
  "guestFirstName": "Jamie",
  "guestLastName": "Lee",
  "totalTickets": 2,
  "status": "pending",
  "pickupLocation": "will_call",
  "attendeeContactEmail": "jamie@example.com",
  "notes": "Guest of tour manager.",
  "ticketType": {
    "ticketTypeId": "00000000-0000-4000-8000-000000000961"
  },
  "passes": [
    {
      "passTypeId": "00000000-0000-4000-8000-000000000951",
      "quantity": 2
    }
  ],
  "assignedSeats": []
}

Response: Create guest request

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000801",
  "resourceType": "guest_request",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/events/00000000-0000-4000-8000-000000000601/guest-requests/00000000-0000-4000-8000-000000000801"
  }
}

Retrieve a guest request

GET/v1/teams/{teamId}/days/{dayId}/events/{eventId}/guest-requests/{guestRequestId}

Returns one guest request record by ID.

Required scopes: guest_request:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.guestRequestId`required	`string:uuid` Guest request identifier.

Response 200

`data`	`object`
`data.dayId`	`string:uuid` Day identifier that owns the event for this guest request.
`data.eventId`	`string:uuid` Event identifier that owns this guest request.
`data.guestFirstName`	`string` Guest's first name.
`data.guestLastName`	`string` Guest's last name.
`data.totalTickets`	`integer` Total number of tickets requested for the guest.
`data.status`	`"pending" \| "approved" \| "denied"` Current approval status for the guest request.
`data.pickupLocation`	`"will_call" \| "in_hand" \| "other"` Where the guest should receive or pick up their tickets.
`data.attendeeContactEmail`	`string:email` Optional email address for the guest or attendee contact.
`data.notes`	`string` Internal notes for this guest request.
`data.ticketType`	`object` Optional ticket type snapshot requested for the guest.
`data.ticketType.ticketTypeId`	`string:uuid` Ticket type identifier requested for this guest.
`data.ticketType.nameAtRequest`	`string` Ticket type display name captured when the guest request was created or updated.
`data.ticketType.abbreviationAtRequest`	`string` Short ticket type label captured when the guest request was created or updated.
`data.passes`	`object[]` Pass type requests associated with this guest request.
`data.passes[].passTypeId`	`string:uuid` Pass type identifier requested for this guest.
`data.passes[].nameAtRequest`	`string` Pass type display name captured when the guest request was created or updated.
`data.passes[].abbreviationAtRequest`	`string` Short pass type label captured when the guest request was created or updated.
`data.passes[].quantity`	`integer` Number of passes requested for this pass type.
`data.assignedSeats`	`object[]` Seat assignments attached after the guest request is fulfilled.
`data.assignedSeats[].id`	`string:uuid` Assigned seat identifier.
`data.assignedSeats[].section`	`string` Venue seating section label.
`data.assignedSeats[].row`	`string` Venue seating row label.
`data.assignedSeats[].seat`	`string` Venue seating seat label.
`data.assignedSeats[].ticketTypeId`	`string:uuid` Ticket type identifier associated with this assigned seat.
`data.id`	`string:uuid` Guest request identifier.
`data.orgId`	`string:uuid` Team identifier that owns this guest request.
`data.isDeleted`	`boolean` Whether the guest request has been deleted.
`data.createdBy`	`string:uuid \| string` User identifier that created the guest request.
`data.createdByName`	`string` Display name captured for the creator.
`data.createdAt`	`string:date-time` ISO 8601 timestamp when the request was created.
`data.updatedAt`	`string:date-time` ISO 8601 timestamp when the request was last updated.
`data.version`	`integer` Current guest request aggregate version.
`data.cursor`	`integer` Latest event-ledger cursor projected into this guest request record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Response: Retrieve guest request

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000801",
    "guestFirstName": "Jamie",
    "guestLastName": "Lee",
    "totalTickets": 2,
    "status": "pending",
    "pickupLocation": "will_call",
    "attendeeContactEmail": "jamie@example.com",
    "notes": "Guest of tour manager.",
    "ticketType": {
      "ticketTypeId": "00000000-0000-4000-8000-000000000961",
      "nameAtRequest": "Reserved",
      "abbreviationAtRequest": "RSV"
    },
    "passes": [
      {
        "passTypeId": "00000000-0000-4000-8000-000000000951",
        "nameAtRequest": "All Access",
        "abbreviationAtRequest": "AA",
        "quantity": 2
      }
    ],
    "assignedSeats": [],
    "dayId": "00000000-0000-4000-8000-000000000201",
    "eventId": "00000000-0000-4000-8000-000000000601",
    "orgId": "00000000-0000-4000-8000-000000000100",
    "isDeleted": false,
    "createdBy": "00000000-0000-4000-8000-000000000101",
    "createdByName": "Jamie Lee",
    "createdAt": "2026-09-01T12:00:00.000Z",
    "updatedAt": "2026-09-01T12:00:00.000Z",
    "version": 1,
    "cursor": 87234
  },
  "meta": {
    "cursor": 87234
  }
}

Update a guest request

PATCH/v1/teams/{teamId}/days/{dayId}/events/{eventId}/guest-requests/{guestRequestId}

Accepts a command to update guest request fields.

Required scopes: guest_request:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.guestRequestId`required	`string:uuid` Guest request identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`updates`required	`object`
`updates.guestFirstName`	`string` Updated guest first name.
`updates.guestLastName`	`string` Updated guest last name.
`updates.totalTickets`	`integer` Updated requested ticket count.
`updates.pickupLocation`	`"will_call" \| "in_hand" \| "other"` Updated pickup location.
`updates.attendeeContactEmail`	`string:email \| null` Updated attendee email, or null to clear it.
`updates.notes`	`string \| null` Updated request notes, or null to clear them.
`updates.ticketType`	`object \| null` Updated ticket type, or null to clear it.
`updates.ticketType.ticketTypeId`	`string:uuid` Ticket type identifier requested for this guest.
`updates.passes`	`object[]` Updated pass requests.
`updates.passes[].passTypeId`required	`string:uuid` Pass type identifier requested for this guest.
`updates.passes[].quantity`required	`integer` Number of passes requested for this pass type.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Delete a guest request

DELETE/v1/teams/{teamId}/days/{dayId}/events/{eventId}/guest-requests/{guestRequestId}

Accepts a command to delete a guest request.

Required scopes: guest_request:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.eventId`required	`string:uuid` Event identifier.
`path.guestRequestId`required	`string:uuid` Guest request identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.