ITEM

A single ticket of an existing order changed. item_id identifies the ticket inside the order.

Header

ob-event: ITEM

Subscribe with

ITEM_TRANSFERITEM_USER_ASSIGNMENTITEM_BARCODE_VALIDATION

Sent to

The entity that owns the sales channel of the order.

Actions

TRANSFERob-subtype: ITEM_TRANSFER

The ticket was transferred to another holder.

TRANSFERob-subtype: ITEM_TRANSFER_RECOVER

A transferred ticket was recovered by its original holder.

USER_ASSIGNMENT

The customer account that owns the ticket changed. Available through the Management API only.

BARCODE_VALIDATION

The ticket barcode was scanned at access control. It has its own payload.

Payload

codestring

Code of the order that contains the ticket.

item_idinteger

Identifier of the ticket in the order.

urlstring

URL of the order in the Orders API.

notificationSubtypestring

TRANSFERSame value as the ob-subtype header.

ob-action: TRANSFER · ob-subtype: ITEM_TRANSFER

{
  "code" : "0017AB3XK9",
  "item_id" : 5512345,
  "url" : "https://api.oneboxtds.com/orders-mgmt-api/v1/orders/0017AB3XK9",
  "notificationSubtype" : "ITEM_TRANSFER"
}

Barcode validation

BARCODE_VALIDATION notifications carry the result of the scan instead of a url.

eventstring

Always ITEM.

actionstring

Always BARCODE_VALIDATION.

codestring

Order code.

item_idinteger

Identifier of the ticket in the order.

barcodestring

Scanned barcode.

validation_datestring

Date of the scan, in ISO 8601 with offset.

validation_statusstring

VALIDATED (entry), VALIDATED_OUT (exit) or NOT_VALIDATED.

ob-action: BARCODE_VALIDATION

{
  "event" : "ITEM",
  "action" : "BARCODE_VALIDATION",
  "code" : "0017AB3XK9",
  "item_id" : 5512345,
  "barcode" : "4012345678901",
  "validation_date" : "2026-10-16T19:42:07+02:00",
  "validation_status" : "VALIDATED"
}