added_to_basket

An item went into the basket: a ticket type or a product, with its quantity and shown price.

One per add. event_id is the item's event, so a filter on the event finds basket activity; event_ids on the basket itself can span events. unit_price is allowed by name (a browser key sends no revenue) so a basket's value can be summed for an abandoned-basket message.

Sent with	browser, server, 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	quantity
Revenue	none: the revenue block is refused. Money-like names allowed in features: unit_price
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
currency	string	no, may be null	stays in features	ISO 4217 code of the amounts on the activity.
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	no, may be null	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.
order_id	string	no, may be null	stays in features	The order in the ticketing system, as its own id. The same value on every activity derived from one order, so they can be joined.
product_id	string	no, may be null	stays in features	The product (merchandise, a drink, a parking place) as the ticketing system knows it.
product_name	string	no, may be null	stays in features	The product's name at the time of sale.
quantity	integer	yes	stays in features	How many of the item were added or removed.
shop_id	string	no, may be null	stays in features	The shop the basket is in.
ticket_type_id	string	no, may be null	stays in features	The ticket type (product) the ticket was bought as.
ticket_type_name	string	no, may be null	stays in features	The ticket type's name at the time of sale, for reading without a join.
unit_price	string	no, may be null	stays in features	The item's price as shown, a decimal string in currency. Not revenue (a browser key cannot send revenue); it lets a basket's value be summed.

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-d37e-7138-8000-d37e138b0000",
      "activity": "added_to_basket",
      "ts": "2026-10-17T20:00:00+02:00",
      "anonymous_customer_id": "evx_web_8f21c0",
      "features": {
        "order_id": "1f2d3c4b-0000-4000-8000-000000000001",
        "shop_id": "shop_01M4XVBYC3FGXCPFRZEPGV20RZ",
        "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c",
        "event_date_id": "9c0e1f2a-0000-4000-8000-000000000002",
        "ticket_type_id": "tt_01M4XVBYC3FGXCPFRZEPGV20RZ",
        "ticket_type_name": "Weekend",
        "product_id": "prd_01M4XVBYC3FGXCPFRZEPGV20RZ",
        "product_name": "Parking",
        "quantity": 1,
        "unit_price": "45.00",
        "currency": "EUR"
      }
    }
  ],
  "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-d37e-7138-8000-d37e138b0000", "activity": "added_to_basket", "ts": "2026-10-17T20:00:00+02:00", "anonymous_customer_id": "evx_web_8f21c0", "features": { "order_id": "1f2d3c4b-0000-4000-8000-000000000001", "shop_id": "shop_01M4XVBYC3FGXCPFRZEPGV20RZ", "event_id": "3a114ef5-6105-48fd-aafc-0ae609d0536c", "event_date_id": "9c0e1f2a-0000-4000-8000-000000000002", "ticket_type_id": "tt_01M4XVBYC3FGXCPFRZEPGV20RZ", "ticket_type_name": "Weekend", "product_id": "prd_01M4XVBYC3FGXCPFRZEPGV20RZ", "product_name": "Parking", "quantity": 1, "unit_price": "45.00", "currency": "EUR" } } ], "debug": true }

Versions

Version	Mode	Key classes	Change
1 (current)	strict	browser, server, 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.