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.
| Field | Type | Description |
|---|---|---|
name | string | Ticket type name. |
description | string or null | Ticket description. |
publicly_listed | boolean | Whether this type may appear on a public event listing. |
external_url | string or null | Off-platform booking URL, when used. |
Prices
These fields live directly on the ticket-type object. Both amounts are in øre (NOK).
| Field | Type | Description |
|---|---|---|
price | integer or null | Ticket price before the service fee. Zero means a free ticket. |
total_price | integer or null | Ticket 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.
| Field | Type | Description |
|---|---|---|
required | boolean | Whether an eligible membership is required to buy this ticket. |
membership_type_ids | string[] | Any one of these membership types satisfies the requirement. Empty when unrestricted. |
Availability
The fields below live inside availability.
| Field | Type | Description |
|---|---|---|
status | string | Current sale state, including on_sale, sold_out, not_started, paused, ended, external or unavailable. |
remaining | integer or null | Tickets remaining after holds and shared event capacity. Null when unknown or uncapped. |
checked_at | string | Time this availability was calculated. |
Sale window
| Field | Type | Description |
|---|---|---|
sale_starts_at | string or null | When ticket sales open. Null for external links. |
sale_ends_at | string or null | When ticket sales close, when configured. Sales also close when the event ends. |
sales_paused | boolean | Whether the organizer has temporarily paused sales. |
Purchase limits and configuration
| Field | Type | Description |
|---|---|---|
max_per_order | integer | Maximum tickets per order. |
allow_multiple | boolean | Whether more than one ticket can be purchased together. |
quantity_available | integer or null | Configured total cap. Read availability.remaining for the current remaining count. |
vat_rate | number | VAT percentage. |
status | string | Ticket visibility status. Can be draft, published, unlisted or archived. |
sales_channel | string | Where the ticket is sold. Can be all or till. |
sort_order | integer | Organizer’s display order. |
Identifiers and integration metadata
| Field | Type | Description |
|---|---|---|
id | string | Stable ticket-type ID. |
object | ticket_type | Resource discriminator. |
org_id | string | Owning organization ID. |
event_id | string | Parent event ID. |
updated_at | string | Last edit of this ticket type. |