scanned_ticket

A ticket was scanned in at the gate.

On the ticket's barcode. A refused or outgoing scan is kept in the supplier log and derives nothing. The scan has no id of its own in the webhook, so one is derived from the record; a resend stores nothing twice.

Sent with	platform keys (see write keys)
Mode	strict: exactly the declared fields; an undeclared key, a wrong type or a missing required key quarantines the event
Version	1 (_schema_version on the stored row)
State	active
Required fields	event_id
Revenue	none: the revenue block is refused
Identity evidence	none
Before consent	no

Fields

The activity's own fields, sent as features. Identifier and attribute fields are moved out of features by the processor; see identifiers and attributes.

Field	Type	Required	What happens to it	Meaning
event_date_id	string	no, may be null	stays in features	The date (edition) of the event, where the event has several.
event_id	string	yes	stays in features	The Eventix event the activity is about. Copied to the stream's _event_id column, so filters on an event are fast; it must be a plain string.
gate	string	no, may be null	stays in features	Where the scan happened: the scanner or gate id.
order_ticket_id	string	no, may be null	stays in features	The ticket within the order: the id of the ticket line, not the barcode.

Example

One activity in a batch to POST /v1/activities, with debug so the answer says what the processor made of it. The envelope page explains every top-level field.

{
  "batch": [
    {
      "activity_id": "0192f1a4-0fbd-7e43-8000-0fbde43b0000",
      "activity": "scanned_ticket",
      "ts": "2026-10-17T20:00:00+02:00",
      "owner_ref": "own:own_01M4XX0033FV7QXDRB5BQBRPGR",
      "identifiers": [
        {
          "type": "barcode",
          "value": "TK-4471",
          "role": "holder",
          "namespace": "weeztix"
        }
      ],
      "features": {
        "event_date_id": "9c0e1f2a-0000-4000-8000-000000000002",
        "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c",
        "gate": "north-1",
        "order_ticket_id": "5e6f7a8b-0000-4000-8000-000000000004"
      }
    }
  ],
  "debug": true
}

Try it

Sends this request from your browser. The key and the endpoint are kept in this browser only.

ServiceWrite key

POST /v1/activities{ "batch": [ { "activity_id": "0192f1a4-0fbd-7e43-8000-0fbde43b0000", "activity": "scanned_ticket", "ts": "2026-10-17T20:00:00+02:00", "owner_ref": "own:own_01M4XX0033FV7QXDRB5BQBRPGR", "identifiers": [ { "type": "barcode", "value": "TK-4471", "role": "holder", "namespace": "weeztix" } ], "features": { "event_date_id": "9c0e1f2a-0000-4000-8000-000000000002", "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c", "gate": "north-1", "order_ticket_id": "5e6f7a8b-0000-4000-8000-000000000004" } } ], "debug": true }

Versions

Version	Mode	Key classes	Change
1 (current)	strict	platform	first version

A published version never changes; a change is a new version, and every stored row says which version it was checked against.