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
| Field | Type | Description |
|---|---|---|
title | string | Event title. |
description | string or null | Plain-text event description. |
description_html | string or null | Formatted event description. Apply your own HTML policy when rendering it. |
image_url | string or null | Cover image URL. |
status | string | Event visibility or lifecycle status. See the values below. |
categories | string[] | Event categories. |
min_age | integer or null | Minimum age, if set. |
age_note | string or null | Additional 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
| Field | Type | Description |
|---|---|---|
starts_at | string | Event start. |
ends_at | string | Event end. |
publish_at | string or null | Scheduled publication time, when set. |
Location
The fields below live inside location.
| Field | Type | Description |
|---|---|---|
name | string or null | Venue name or custom label. |
address | string or null | Street address. |
city | string or null | Municipality. |
latitude | number or null | Decimal latitude. |
longitude | number or null | Decimal 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.
| Field | Type | Description |
|---|---|---|
from_ticket_type_id | string or null | ID of the public ticket type used for the from-price. |
from_amount | integer or null | Ticket price before the service fee, in øre. |
from_total_amount | integer or null | Ticket price plus its standard service fee, in øre. |
requires_membership | boolean | True 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.
| Field | Type | Description |
|---|---|---|
status | string | Current sale state. See the values below. |
remaining | integer or null | Seats remaining after holds and shared capacity. Null when unknown or uncapped. |
checked_at | string | Time 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
| Field | Type | Description |
|---|---|---|
url | string or null | Stello event page and booking URL. |
free_entry | boolean | Whether the organizer offers entry without a ticket. Ticket types take precedence when present. |
refund_policy | string or null | Event-specific refund terms, when provided. |
ticket_channel | string or null | Configured ticketing channel. Can be inapp, external, free or null. |
ticket_types_url | string | Authenticated endpoint for this event’s ticket types. Fetch it from your server. |
Identifiers and integration metadata
| Field | Type | Description |
|---|---|---|
id | string | Stable event ID. Use this when storing or deduplicating events. |
object | event | Resource discriminator. |
org_id | string | ID of the organization owning the event, including the sub-organization when read through a parent key. |
slug | string | Editable event URL segment. |
updated_at | string or null | Last event metadata edit. Prices and inventory can change separately. |
max_capacity | integer or null | Configured shared capacity, when set. |
fee_model | string | Who 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"
}
}