List experiences — API

GET/api/v1/experiences

Scope: experiences:read

Every experience in the organization, published and unpublished. Requires the "experiences:read" scope.

Query parameters#

Field	Type	Description
`limit`	integermin 1 · max 100 · default 25	How many results to return, 1-100. Defaults to 25.
`order`	stringdefault "desc"	Sort by creation time: "desc" (newest first, default) or "asc". `"asc""desc"`
`starting_after`	string≥ 1 chars	The next_cursor from a previous page. Opaque — pass it back verbatim.
`published`	string	Filter on publication state. Omit to get both published and unpublished. `"true""false"`
`updated_since`	string	Only experiences changed at or after this ISO 8601 timestamp.

Example request#

bash

curl -X GET "https://your-site.awrora.app/api/v1/experiences" \
  -H "Authorization: Bearer $AWRORA_API_KEY"

Responses#

200A page of experiences.
400Invalid request — codes "validation_failed" or, on an endpoint that requires one, "idempotency_key_required".
401Missing, invalid, revoked or expired API key — codes "api_key_missing", "api_key_invalid", "api_key_revoked", "api_key_expired".
403The API app is off, the plan does not include the API, or the key lacks the required scope — codes "app_not_enabled", "plan_upgrade_required", "insufficient_scope" (the last carries "required_scope").
429Rate limit exceeded — code "rate_limited". See the x-ratelimit-* headers.
500Something went wrong on our side — code "internal_error".

Response 200

Field Type Description

datarequired

object[]

The page of results, in the requested order.

Field Type Description

idrequired

string

Awrora id (UUID) for the experience.

slugrequired

string

URL slug, unique within the organization.

titlerequired

string

Public title.

is_publishedrequired

boolean

True when the experience is visible on the storefront. Unpublished experiences are returned too — filter with ?published=.

excerptrequired

string | null

Short teaser text, or null.

duration_minutesrequired

integer | null

Length of the experience in minutes, or null when unset. This is the source: `duration` is derived display text, and a departure without `ends_at` runs this long.

durationrequired

string | null

Duration as display text, e.g. "3 timmar". Derived from duration_minutes.

difficultyrequired

string | null

Difficulty as written by the merchant, or null.

addressrequired

string | null

Meeting point address, or null.

latituderequired

number | null

WGS84 latitude of the meeting point, or null.

longituderequired

number | null

WGS84 longitude of the meeting point, or null.

image_urlrequired

string | null

Cover image URL, or null.

languagesrequired

string[]

Language codes the experience is offered in. May be empty.

tagsrequired

string[]

Merchant-defined tags. May be empty.

price_fromrequired

object | null

Lowest advertised price, or null when the merchant published no machine-readable amount.

Field	Type	Description
`amount_minor`required	integermin -9007199254740991 · max 9007199254740991	Amount in the currency's minor unit (öre, cents). 120000 means 1200.00.
`currency`required	string	ISO 4217 currency code, uppercase. For example "SEK".

price_tiersrequired

object[]

The bookable price tiers. Use the "id" of one of these as "tier_id" when creating a booking. An experience with no configured tiers reports a single "standard" tier built from its advertised price.

Field Type Description

idrequired

string

Tier id. Pass this as "tier_id" when creating a booking.

namerequired

string

Merchant-facing label, e.g. "Vuxen" or "Barn".

pricerequired

object | null

Price per unit, or null when the merchant published no machine-readable amount.

Field	Type	Description
`amount_minor`required	integermin -9007199254740991 · max 9007199254740991	Amount in the currency's minor unit (öre, cents). 120000 means 1200.00.
`currency`required	string	ISO 4217 currency code, uppercase. For example "SEK".

seats_per_unitrequired

integermin -9007199254740991 · max 9007199254740991

How many seats one unit of this tier consumes. Usually 1; a "family ticket" may consume more.

min_participantsrequired

integer | null

Minimum participants for a departure to run, or null when not set.

hours_before_booking_closesrequired

integer | null

Lead time in hours before departure when booking closes. Null means the organization default applies.

created_atrequired

string

ISO 8601 timestamp with offset.

updated_atrequired

string

ISO 8601 timestamp with offset.

has_morerequired

boolean

True when more results exist after this page. Fetch them with next_cursor.

next_cursorrequired

string | null

Pass this back as ?starting_after= to fetch the next page. Null when has_more is false. Opaque — do not parse it.

200 response

{
  "data": [
    {
      "id": "res_8f2k3n",
      "slug": "string",
      "title": "string",
      "is_published": true,
      "excerpt": "string",
      "duration_minutes": -9007199254740991,
      "duration": "string",
      "difficulty": "string",
      "address": "string",
      "latitude": 1,
      "longitude": 1,
      "image_url": "https://example.com/webhooks/awrora",
      "languages": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "price_from": {
        "amount_minor": -9007199254740991,
        "currency": "SEK"
      },
      "price_tiers": [
        {
          "id": "res_8f2k3n",
          "name": "string",
          "price": {
            "amount_minor": null,
            "currency": null
          },
          "seats_per_unit": -9007199254740991
        }
      ],
      "min_participants": -9007199254740991,
      "hours_before_booking_closes": -9007199254740991,
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}