Skip to Content
Ticket-type object

Ticket-type object

Ticket types describe an event’s prices, sale windows and membership requirements. Retrieve them from GET /v1/events/{event_id}/ticket-types using pagination.

All money is NOK, in øre. 10000 means 100 kr. A null amount means the price is unknown.

Display a ticket type

For a public website, select types where publicly_listed is true. Then use the name, description and total price. A listed ticket can be scheduled or sold out, so check availability.status before saying it is on sale.

FieldTypeDescription
namestringTicket type name.
descriptionstring or nullTicket description.
publicly_listedbooleanWhether this type may appear on a public event listing.
external_urlstring or nullOff-platform booking URL, when used.

Prices

These fields live directly on the ticket-type object. Both amounts are in øre (NOK).

FieldTypeDescription
priceinteger or nullTicket price before the service fee. Zero means a free ticket.
total_priceinteger or nullTicket price including the standard service fee.

Subtract price from total_price to find the service fee. External ticket totals may be unknown. Final checkout totals can change with discounts and payment method.

Membership requirements

The fields below live inside membership_requirement.

FieldTypeDescription
requiredbooleanWhether an eligible membership is required to buy this ticket.
membership_type_idsstring[]Any one of these membership types satisfies the requirement. Empty when unrestricted.

Availability

The fields below live inside availability.

FieldTypeDescription
statusstringCurrent sale state, including on_sale, sold_out, not_started, paused, ended, external or unavailable.
remaininginteger or nullTickets remaining after holds and shared event capacity. Null when unknown or uncapped.
checked_atstringTime this availability was calculated.

Sale window

FieldTypeDescription
sale_starts_atstring or nullWhen ticket sales open. Null for external links.
sale_ends_atstring or nullWhen ticket sales close, when configured. Sales also close when the event ends.
sales_pausedbooleanWhether the organizer has temporarily paused sales.

Purchase limits and configuration

FieldTypeDescription
max_per_orderintegerMaximum tickets per order.
allow_multiplebooleanWhether more than one ticket can be purchased together.
quantity_availableinteger or nullConfigured total cap. Read availability.remaining for the current remaining count.
vat_ratenumberVAT percentage.
statusstringTicket visibility status. Can be draft, published, unlisted or archived.
sales_channelstringWhere the ticket is sold. Can be all or till.
sort_orderintegerOrganizer’s display order.

Identifiers and integration metadata

FieldTypeDescription
idstringStable ticket-type ID.
objectticket_typeResource discriminator.
org_idstringOwning organization ID.
event_idstringParent event ID.
updated_atstringLast edit of this ticket type.