External Ticketing API (0.1)

Sent when a customer product (an individual ticket) is canceled, either on its own or as part of an order cancellation. Retrieve it with GET /events/{event_id}/orders/{order_id}/products/{customer_product_id}.

Sent when an order is canceled, followed by a customer_product.canceled message for each ticket in the order.

Sent when an order is completed. Retrieve it with GET /events/{event_id}/orders/{order_id}.

Returns all customer products (the individual tickets and other products issued to customers) across all of your events. Accepts the same filters as the event-level list.

Returns all customer products (the individual tickets and other products issued to customers) of one event.

Returns the customer products (the individual tickets and other products issued to the customer) of one order. Accepts the same filters as the event-level and organisation-level lists.

Returns the details of one customer product (an individual ticket or other product issued to a customer): the customer's details, the product, the event and venue, the seat (null for events without seating), how often and when it was last scanned, and the tracking parameters of the order it belongs to.

Cancels one customer product (an individual ticket or other product issued to a customer). Its barcode can no longer be used for entry and the product's stock is increased by one. The order it belongs to is not changed, and no refund is made. Canceling a customer product that is already canceled returns 409.

Returns your organisation's active events.

Creates a new event. description and discount_label are objects keyed by language code (for example {"en": "...", "nl": "..."}); provide them for the languages you list in languages.

Deactivates an event: it is not removed, but is_active becomes false. Calling this on an event that is already inactive also returns 204.

Returns the details of one event, including its description and discount label in every language they are available in.

Replaces all editable fields of an event. This is a full replacement, not a partial update: send the complete event as you want it to be stored. Fields you leave out or set to null, and arrays you send empty, are cleared.

Returns the active sales channels of an event. Each channel has a public shop url that you can link your customers to.

Creates a discount campaign for an event. Set discount_type to choose the kind of discount. With ORDER, the discount applies to the whole order: provide a rate, a rate_type (MONETARY or PERCENTAGE) and the discount_code your customers will enter. With PRODUCT, the discount applies to specific products: provide discount_campaign_products with a product_uuid, max_usage, rate and currency_id for each product (each rate_type must be MONETARY); the discount code is generated for you. The response contains the campaign id, the discount_code (the one you supplied for ORDER, the generated one for PRODUCT) and the rate, or the per-product entries.

Updates the name, max_usage, online_from and online_till of a discount campaign. The rate, currency, discount code and per-product entries cannot be changed after the campaign is created; to change them, create a new campaign. The response has the same shape as the create response.

Returns the marketing trackers of an event, grouped by channel (shop). Each group has totals for clicks, orders and tickets sold, and lists its trackers with their own statistics and the tracking link to share.

Creates a marketing tracker for one of your event's channels (shops). Pass the channel's uuid, as returned by GET /events/{event_id}/channels, as viewport_uuid. The tracker gets its own tracking link, so you can see how many clicks, orders and tickets each promotion brings in. Supported channels are INSTAGRAM, FACEBOOK, TIKTOK, WHATSAPP, NEWSLETTER, X, SHOPIFY and OTHER. The SPOTIFY and AUTOMATED_EMAIL channels are managed by CM.com and cannot be created here.

Deletes a marketing tracker. Only trackers that you created can be deleted; the SPOTIFY and AUTOMATED_EMAIL trackers are managed by CM.com and cannot be deleted.

Returns the orders of an event, optionally filtered by status, product, sales origin or completion time.

Creates an order for an event. There are two ways to use it. With complete=true the order is completed immediately, using the payment_method and delivery_method in the same request. With complete=false (the default) the order is created with status PENDING and reserves the requested tickets; you then finish it with PUT /events/{event_id}/orders/{order_id}/complete, or release the tickets with PUT /events/{event_id}/orders/{order_id}/cancel. The response has the same shape as GET /events/{event_id}/orders/{order_id}. Use external_batch_id to store your own reference for the order.

Returns the details of one order: its status, the customer's details, the payment method, the tickets that were ordered and the consents the customer gave.

Cancels an order that is still PENDING and makes the tickets it reserved available again. This endpoint does not refund or cancel completed orders; to cancel individual tickets of a completed order, use the customer product cancel endpoint. Canceling an order that is already canceled returns 409.

Completes an order that was created with complete=false and is still PENDING. If you leave out payment_method it defaults to FREE, and if you leave out delivery_method it defaults to NONE. Completing an order that is already completed returns 409.