Convova
API reference

Products

Sellable items of two kinds, `ticket` and `add-on`, with their current price. An add-on rides on one ticket in the same order; `attachesTo` lists the ticket types it can be added to (empty = all). Amounts are integer minor units (cents) with a lowercase ISO currency code.

List products for sale

GET
/events/{slug}/products

The event's visible products, each with its currently-active price (null = not currently priced). onSale = purchasable right now (sales window open, priced, not sold out). perOrderMax caps a ticket per order; perTicketMax caps an add-on per ticket. Pass ?include=<productId> (repeatable) to add a hidden product the host linked to.

Path Parameters

slug*string

The event's unique slug.

Response Body

application/json

application/json

curl -X GET "https://example.com/events/string/products"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "kind": "ticket",      "ticketTypeId": "2205b8a7-79ec-406f-ac86-a5e81fe84318",      "attachesTo": [        "5a8e8ea6-734c-40f9-8cfc-970dab3360a8"      ],      "name": "string",      "description": "string",      "imageUrl": "string",      "salesStartAt": "2019-08-24T14:15:22Z",      "salesEndAt": "2019-08-24T14:15:22Z",      "perOrderMax": 1,      "perTicketMax": 1,      "price": {        "unitAmount": 0,        "currency": "string"      },      "soldOut": true,      "onSale": true    }  ],  "error": null,  "pagination": {    "offset": 0,    "limit": 0,    "total": 0,    "hasMore": true  }}