Skip to Content
Event object

Event object

An event contains the information you need for a listing or detail page. The list and detail endpoints return the same shape.

Beta — fields can be added during the beta. Existing fields are not removed or renamed without notice in the changelog.

All money is NOK, in øre. 10000 means 100 kr. Dates use UTC ISO 8601 timestamps. A null value means the information is unavailable or does not apply.

Display an event

Use the title, description, cover image, dates and booking URL to build an event card. Location, pricing and availability are nested objects with their own sections below.

{ "title": "Student concert", "description": "Live music at the student house.", "image_url": "https://example.com/event-cover.jpg", "status": "published", "starts_at": "2026-12-04T18:00:00.000Z", "ends_at": "2026-12-04T22:00:00.000Z", "url": "https://stello.no/e/example/student-concert", "location": { "name": "Student house", "city": "Ålesund" }, "pricing": { "from_total_amount": 10000, "requires_membership": false }, "availability": { "status": "on_sale", "remaining": 120 } }

This excerpt highlights the display fields. The complete response also contains the fields documented below. Retrieve individual prices through the ticket-type endpoint and ticket-type reference.

Event details

FieldTypeDescription
titlestringEvent title.
descriptionstring or nullPlain-text event description.
description_htmlstring or nullFormatted event description. Apply your own HTML policy when rendering it.
image_urlstring or nullCover image URL.
statusstringEvent visibility or lifecycle status. See the values below.
categoriesstring[]Event categories.
min_ageinteger or nullMinimum age, if set.
age_notestring or nullAdditional age policy.

The status values are published, draft, scheduled, unlisted, canceled and ended. List requests default to published events. Use endpoint filters to include other statuses or past events.

Dates

FieldTypeDescription
starts_atstringEvent start.
ends_atstringEvent end.
publish_atstring or nullScheduled publication time, when set.

Location

The fields below live inside location.

FieldTypeDescription
namestring or nullVenue name or custom label.
addressstring or nullStreet address.
citystring or nullMunicipality.
latitudenumber or nullDecimal latitude.
longitudenumber or nullDecimal longitude.

Pricing

The fields below live inside pricing. All amounts are in øre (NOK). For an event card, use from_total_amount to include the standard service fee.

FieldTypeDescription
from_ticket_type_idstring or nullID of the public ticket type used for the from-price.
from_amountinteger or nullTicket price before the service fee, in øre.
from_total_amountinteger or nullTicket price plus its standard service fee, in øre.
requires_membershipbooleanTrue when the from-price requires an eligible membership.

The from-price uses the public ticket type with the lowest standard total. Both amounts refer to that same type. Subtract from_amount from from_total_amount to find the service fee. Label member prices when requires_membership is true.

A null amount means a price is unavailable. Known free tickets have a zero amount. External ticket prices may be unknown. Discounts and payment-method additions can change the final checkout amount.

When a price summary is unavailable

An event can have no publicly listed tickets, an unknown external price, or a ticket set too large to summarize in one read. The current summary read supports up to 100 ticket types. For a full breakdown, paginate through ticket_types_url.

Availability

The fields below live inside availability.

FieldTypeDescription
statusstringCurrent sale state. See the values below.
remaininginteger or nullSeats remaining after holds and shared capacity. Null when unknown or uncapped.
checked_atstringTime this availability was calculated.

Availability status can be on_sale, sold_out, not_started, paused, ended, external, free_entry or unavailable. Inventory can change after the response. Checkout checks availability again.

Booking and entry

FieldTypeDescription
urlstring or nullStello event page and booking URL.
free_entrybooleanWhether the organizer offers entry without a ticket. Ticket types take precedence when present.
refund_policystring or nullEvent-specific refund terms, when provided.
ticket_channelstring or nullConfigured ticketing channel. Can be inapp, external, free or null.
ticket_types_urlstringAuthenticated endpoint for this event’s ticket types. Fetch it from your server.

Identifiers and integration metadata

FieldTypeDescription
idstringStable event ID. Use this when storing or deduplicating events.
objecteventResource discriminator.
org_idstringID of the organization owning the event, including the sub-organization when read through a parent key.
slugstringEditable event URL segment.
updated_atstring or nullLast event metadata edit. Prices and inventory can change separately.
max_capacityinteger or nullConfigured shared capacity, when set.
fee_modelstringWho pays the platform fee. Can be org_pays, split or buyer_pays.

Publishing on your website

Display published events and publicly listed ticket types. Use the website integration guide for a server-side example.

Complete response

Show the full event response

{ "data": { "id": "event_example", "object": "event", "org_id": "org_example", "title": "Student concert", "slug": "student-concert", "description": "Live music at the student house.", "description_html": "<p>Live music at the student house.</p>", "status": "published", "starts_at": "2026-12-04T18:00:00.000Z", "ends_at": "2026-12-04T22:00:00.000Z", "publish_at": null, "location": { "name": "Student house", "address": null, "city": "Ålesund", "latitude": null, "longitude": null }, "image_url": "https://example.com/event-cover.jpg", "categories": [], "min_age": 18, "age_note": null, "max_capacity": 200, "url": "https://stello.no/e/example/student-concert", "updated_at": "2026-11-09T12:00:00.000Z", "free_entry": false, "refund_policy": null, "ticket_channel": "inapp", "fee_model": "org_pays", "pricing": { "from_ticket_type_id": "type_example", "from_amount": 10000, "from_total_amount": 10000, "requires_membership": false }, "availability": { "status": "on_sale", "remaining": 120, "checked_at": "2026-11-09T12:00:00.000Z" }, "ticket_types_url": "https://api.stello.no/v1/events/event_example/ticket-types" } }