List experiences

GET/v2/experiences

Works without an API key; send X-API-Key to act as your partner account.

Returns a paginated list of experiences visible to the caller.

Visibility

Anonymous and unauthenticated requests see only ACTIVE experiences that are publicly listed. Authenticated callers additionally see their own experiences, at any status, plus any experiences that other organizers have explicitly shared with them. Custom one-off experiences created for a specific private booking are never included in this list — they exist only for their booking and are not reachable here.

Response shape

Experiences you own are serialized with extra owner-only fields (contacts, notificationSettings, the full commissionSettings list, availabilitySource, createdAt, updatedAt, ...); other experiences use the public read shape. Both shapes can appear in the same results array.

Ordering

Default order is by relevance (highest first), then newest first. Override with the sort parameter.

Availability window filtering

When from and until are given (both required together, YYYY-MM-DD), only experiences having at least one bookable availability slot with a start date inside the window are returned. This is a schedule-only check — capacity and resources are not consulted.

Requestbash
curl "https://api.turneo.co/v2/experiences" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • pageinteger

    Page number of the paginated result set (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Number of results per page. Defaults to 50.

    Default:
    50
    Example:
    25
  • nopaginationboolean

    When true, disables pagination and returns a bare array of experiences instead of the {count, next, previous, results} envelope. Currently capped at 500 results as a safety limit.

    Example:
    false
  • idstring

    Comma-separated list of experience UUIDs to fetch. When present, the default ACTIVE-only restriction for non-owned experiences is lifted. Returns 400 when the first value is not a valid UUID.

    Example:
    5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b
  • storeIdstring

    Comma-separated list of store IDs. Restricts results to experiences assigned to those stores (assignments are looked up in the store configuration database).

    Example:
    64a1f0c2e4b0a1b2c3d4e5f6
  • elementIdstring

    Comma-separated list of embeddable-element IDs. Restricts results to experiences configured on those elements, returned in the order they are arranged in within the element. Elements are honoured in the order listed here, and within an element its own configured order; an experience on several of them keeps its first position and is returned once. Experiences the request cannot see drop out, so the result is a subsequence of that order. An explicit sort overrides it.

    Example:
    element-123
  • namestring

    Exact name match, checked against every supported language of the multilang name. Partial values will not match — use nameContains or search for that.

    Example:
    Sunset Cruise
  • nameContainsstring

    Case-insensitive substring match on the English name only.

    Example:
    cruise
  • searchstring

    Free-text search. Case-insensitive substring match across the multilang name (all languages), category theme names, location city and location country. Whitespace-only terms are ignored.

    Example:
    paris
  • categoriesstring

    Comma-separated list of category names. Each value is matched against the category type, the category theme list, and custom category-theme default names.

    Example:
    Day trips,Dining
  • countrystring

    Exact match on location.country.

    Example:
    France
  • citystring

    Comma-separated list of cities. Matches experiences whose location.city equals one of the values, or whose geo-location lies within the configured search radius of a known city with that name (proximity search).

    Example:
    Paris,Rome
  • locationstring

    Comma-separated list of cities matched exactly against location.city — no proximity radius, unlike city. Values are trimmed, so ?location=Paris, Rome works. location__city and meetingPoint__city are accepted as legacy aliases.

    Example:
    Paris, Rome
  • experienceTypestring

    Comma-separated list of experience types: EXPERIENCE (bookable), RETAIL (retail products) and VOUCHER (gift vouchers). Unknown values match nothing.

    Example:
    RETAIL,VOUCHER
  • statusstring

    Comma-separated list of experience statuses (ACTIVE, DRAFT, INACTIVE, CATALOGUE). Passing this lifts the default ACTIVE-only restriction on non-owned experiences (experiences shared only with specific partners stay limited to them).

    Example:
    ACTIVE,DRAFT
  • publishedAtFromstring (date)

    Only experiences first published on or after this date. Must be a plain YYYY-MM-DD date — datetimes are rejected with 400.

    Example:
    2026-01-01
  • publishedAtUntilstring (date)

    Only experiences first published on or before this date. Must be a plain YYYY-MM-DD date — datetimes are rejected with 400.

    Example:
    2026-06-30
  • sortstring

    Sort override. Accepts the bracket convention field[asc|desc] for publishedAt, createdAt and updatedAt (e.g. updatedAt[desc]), plus the legacy forms publishedAt / -publishedAt. Unrecognized values are silently ignored and the default sort-score ordering applies. A recognized value also overrides the element ordering applied by elementId.

    Example:
    updatedAt[desc]
  • fromstring (date)

    Start of an availability window (YYYY-MM-DD). Must be passed together with until (400 otherwise) and must not be after until. Filters to experiences with at least one bookable slot in the window.

    Example:
    2026-07-10
  • untilstring (date)

    End of the availability window (YYYY-MM-DD). See from.

    Example:
    2026-07-20
  • organizer__partnerIdstring

    Comma-separated list of organizer partner IDs to filter by.

    Example:
    partner-abc,partner-def
  • organizer__partnerTypestring

    Filter by the organizer's partner type (e.g. Organizer, BOTH).

    Example:
    Organizer
  • organizer__namestring

    Exact match on the organizer's name.

    Example:
    Acme Tours
  • unapproved_reviewsboolean

    When true, the embedded reviews object also includes reviews that have not been approved yet (any status). Default is accepted reviews only.

    Example:
    false
  • languagestring

    Language for multilingual fields. Multilang fields resolve to a single string in this language when a complete translation exists, otherwise fall back to English.

    Default:
    en
    Example:
    de
  • showTranslationsboolean

    When true, multilingual fields are returned as full per-language objects ({"en": "...", "de": "..."}) instead of a resolved single string. Intended for editing UIs.

    Example:
    false

Responses

200object

Paginated list of experiences. With nopagination=true the body is a bare array of experience objects instead.

  • countinteger

    Total number of experiences matching the query, across all pages.

    Example:
    137
  • nextstring (uri)nullable

    URL of the next page, or null on the last page.

    Example:
    https://api.turneo.co/v2/experiences?page=2&page_size=50
  • previousstring (uri)nullable

    URL of the previous page, or null on the first page.

  • resultsobject[]

    Experiences on this page. Rows the caller owns use the owner shape (experienceOwnDetail); other rows use the public shape.

    Child fields
    • idstring (uuid)

      Experience UUID.

      Example:
      5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b
    • namestring or map of string

      Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

      Accepted shapes
      • Either string

      • Or map of string

    • descriptionstring or map of string

      Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

      Accepted shapes
      • Either string

      • Or map of string

    • highlightstring or map of string

      Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

      Accepted shapes
      • Either string

      • Or map of string

    • otherNotesstring or map of string

      Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

      Accepted shapes
      • Either string

      • Or map of string

    • noReservationNotestring or map of string

      Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

      Accepted shapes
      • Either string

      • Or map of string

    • codestringnullable

      Optional internal reference code of the organizer.

      Example:
      KAYAK-01
    • statusstring

      Lifecycle status. Only ACTIVE experiences are visible to other partners by default.

      Allowed values:
      ACTIVEDRAFTINACTIVECATALOGUE
      Example:
      ACTIVE
    • experienceTypestring

      EXPERIENCE is bookable through options and slots. RETAIL is a retail product and VOUCHER a gift voucher; both sell from SKUs instead (see the Retail group) and have no options, slots or participant types.

      Allowed values:
      EXPERIENCERETAILVOUCHER
      Example:
      EXPERIENCE
    • organizerobject

      Embedded summary of the organizer (owner) of the experience.

      Child fields
      • namestring

        Organizer display name.

        Example:
        Acme Tours
      • partnerIdstring

        Organizer's public partner ID.

        Example:
        acme-tours
      • phonestringnullable

        Contact phone number.

        Example:
        +385911234567
      • partnerEmailstring (email)

        Organizer's email address.

        Example:
        hello@acmetours.com
      • partnerRatingnumber (double)nullable

        Aggregate partner rating.

        Example:
        4.8
      • partnerReviewsintegernullable

        Number of reviews contributing to the partner rating.

        Example:
        132
      • logostring (uri)nullable

        Organizer logo URL.

        Example:
        https://res.cloudinary.com/turneo/image/upload/logo.png
      • websitestring (uri)nullable

        Organizer website.

        Example:
        https://acmetours.com
      • aboutUsstringnullable

        Organizer self-description.

        Example:
        Family-run kayak outfitter since 2005.
      • supportEmailstring (email)nullable

        Dedicated support email, when different from the main address.

        Example:
        support@acmetours.com
      • featureFlagsobject

        Feature flags enabled for this organizer.

    • categoriesobjectnullable

      Category assignment, e.g. {"type": "Water sports", "theme": [...]}.

    • categoryThemesobject[]

      Custom category themes attached to the experience.

      Child fields
      • idstring (uuid)

        Category theme ID.

        Example:
        2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • nameDefaultstring

        Default (untranslated) name of the theme.

        Example:
        Family friendly
      • isDefaultboolean

        Whether this is one of the partner's default themes.

        Example:
        false
      • descriptionstringnullable

        Optional description of the theme.

        Example:
        Great for kids of all ages.
    • locationobjectnullable

      Where the experience takes place. Coordinates drive geo search and the local timezone.

      Child fields
      • citystring

        City name. Required (with country and coordinates) while the experience is ACTIVE.

        Example:
        Split
      • countrystring

        Country name.

        Example:
        Croatia
      • addressstringnullable

        Street address.

        Example:
        Riva 1
      • latitudenumber (double)

        Latitude in decimal degrees.

        Example:
        43.508
      • longitudenumber (double)

        Longitude in decimal degrees.

        Example:
        16.44
      • descriptionstringnullable

        Free-text directions or notes about the location.

        Example:
        Next to the ferry terminal.
    • meetingPointobjectnullabledeprecated

      Deprecated single meeting point — use meetingPoints instead.

    • meetingPointsobject[]

      All meeting points of the experience.

      Child fields
      • idstring (uuid)

        Meeting point ID. Include on update to modify an existing point.

        Example:
        7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d
      • typestringnullable

        Meeting point type (e.g. CENTRAL_MEETING_POINT).

        Example:
        CENTRAL_MEETING_POINT
      • citystringnullable

        City of the meeting point.

        Example:
        Split
      • countrystringnullable

        Country of the meeting point.

        Example:
        Croatia
      • addressstringnullable

        Street address.

        Example:
        Riva 1
      • descriptionstringnullable

        How to find the guide / extra instructions.

        Example:
        Look for the yellow flag.
      • latitudenumber (double)

        Latitude in decimal degrees.

        Example:
        43.508
      • longitudenumber (double)

        Longitude in decimal degrees.

        Example:
        16.44
      • timeBeforeStartintegernullable

        Minutes before the start time the traveler should arrive.

        Example:
        15
      • titlestringnullable

        Short display title of the meeting point.

        Example:
        Riva promenade
    • pickupobjectnullable

      Pickup configuration for the experience.

      Child fields
      • valuestring

        Pickup offering (free-form configuration value).

        Example:
        Hotel pickup available
      • rulesstring

        Rules or conditions attached to pickup.

        Example:
        Within 5 km of the city center only.
    • allowFreePickupboolean

      Whether the traveler may enter a free-form pickup location.

      Example:
      true
    • durationobjectnullable

      Duration split into days/hours/minutes. On experience reads this is computed from the first active, non-custom option that defines a duration — null when no active option has one.

      Child fields
      • daysinteger

        Whole days component.

        Example:
        0
      • hoursinteger

        Hours component.

        Example:
        2
      • minutesinteger

        Minutes component.

        Example:
        30
    • ratingobjectnullabledeprecated

      Deprecated legacy rating blob — use reviews instead.

    • videosstring (uri)[]

      Video URLs (max 20). Always an array, never null.

    • maxPriceobjectnullable

      A price boundary condition (used by maxPrice / minPrice).

      Child fields
      • amountnumber (double)

        Monetary amount over every active variant, members-only included.

        Example:
        79
      • freeOfChargeboolean

        True when every variant in scope is free. Present on minPrice only.

        Example:
        false
      • publicobjectnullable

        Same boundary over public variants only (restricted=false). null when no public variant is priced; absent until the experience is recomputed.

        Child fields
        • amountnumber (double)
          Example:
          99
        • unitstringnullable

          Pricing unit the amount applies to (e.g. per person).

          Example:
          Person
        • freeOfChargeboolean

          Present on minPrice scopes only.

          Example:
          false
      • privateobjectnullable

        Same boundary over what a restricted=true viewer can book: an option's members-only variants when it has any, else its public ones. null when nothing priced qualifies; absent until the experience is recomputed.

        Child fields
        • amountnumber (double)
          Example:
          99
        • unitstringnullable

          Pricing unit the amount applies to (e.g. per person).

          Example:
          Person
        • freeOfChargeboolean

          Present on minPrice scopes only.

          Example:
          false
      • currencystring

        ISO 4217 currency code.

        Example:
        EUR
      • unitstringnullable

        Pricing unit the amount applies to (e.g. per person).

        Example:
        person
    • minPriceobjectnullable

      A price boundary condition (used by maxPrice / minPrice).

      Child fields
      • amountnumber (double)

        Monetary amount over every active variant, members-only included.

        Example:
        79
      • freeOfChargeboolean

        True when every variant in scope is free. Present on minPrice only.

        Example:
        false
      • publicobjectnullable

        Same boundary over public variants only (restricted=false). null when no public variant is priced; absent until the experience is recomputed.

        Child fields
        • amountnumber (double)
          Example:
          99
        • unitstringnullable

          Pricing unit the amount applies to (e.g. per person).

          Example:
          Person
        • freeOfChargeboolean

          Present on minPrice scopes only.

          Example:
          false
      • privateobjectnullable

        Same boundary over what a restricted=true viewer can book: an option's members-only variants when it has any, else its public ones. null when nothing priced qualifies; absent until the experience is recomputed.

        Child fields
        • amountnumber (double)
          Example:
          99
        • unitstringnullable

          Pricing unit the amount applies to (e.g. per person).

          Example:
          Person
        • freeOfChargeboolean

          Present on minPrice scopes only.

          Example:
          false
      • currencystring

        ISO 4217 currency code.

        Example:
        EUR
      • unitstringnullable

        Pricing unit the amount applies to (e.g. per person).

        Example:
        person
    • languagesstringnullable

      Comma-separated languages the experience is conducted in.

      Example:
      English,German
    • cutOffTimeinteger

      Latest possible booking, in hours before the start time.

      Example:
      4
    • refundPolicyobjectnullable

      Tiered refund policy. Tiers are evaluated by hours remaining before the experience start; the matching tier's percentage is refunded on cancellation.

      Child fields
      • tiersobject[]

        Refund tiers, typically ordered from most to least generous.

        Child fields
        • hoursBeforeStartinteger

          Minimum hours before start for this tier to apply.

          Example:
          48
        • refundPercentageinteger

          Percentage of the price refunded in this tier (0-100).

          Example:
          100
    • supportContactobject[]nullable

      Support contacts overriding the organizer defaults, as {type, value} pairs.

      Child fields
      • typestring

        Contact channel (email, phone, whatsapp).

        Example:
        email
      • valuestring

        The address / number.

        Example:
        support@acmetours.com
    • travellerTypeScoresobjectnullable

      AI-computed suitability scores per traveler type.

    • availableFromstring (date)nullable

      When the experience has no bookable future availability, the date we expect it to become available again; null when it is currently available.

      Example:
      2026-09-01
    • publishedAtstring (date-time)nullable

      When the experience was (last) activated. null for never-published drafts.

      Example:
      2026-04-02T09:15:00Z
    • commissioninteger

      Commission percentage that applies to the requesting partner — their private reseller rate when one exists, the marketplace rate otherwise, and 0 for organizers selling their own experience (Hub requests see the marketplace rate).

      Example:
      20
    • commissionSettingsobject[]nullable

      On the public shape, only populated (with a single row) when the requesting partner has a private reseller commission on this experience; otherwise null. Owners see the complete list.

      Child fields
      • idstring (uuid)

        Commission row ID. Submit on update to edit in place; omit to create.

        Example:
        4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f
      • typestring

        Whether this is the default marketplace rate or a per-reseller override.

        Allowed values:
        MARKETPLACERESELLER
        Example:
        MARKETPLACE
      • resellerstringnullable

        Partner ID of the reseller this row applies to. Must be null/absent for MARKETPLACE rows.

        Example:
        grand-hotel
      • valueinteger

        Commission percentage.

        Example:
        20
    • includedobject[]

      What the price includes.

      Child fields
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • inclusionIdstring

        Stable identifier of the inclusion (auto-generated when omitted on create). On update, submit it to edit the row in place; rows whose ID is missing from the submitted list are deleted.

        Example:
        64a1f0c2e4b0a1b2c3d4e5f6
    • excludedobject[]

      What the price excludes.

      Child fields
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • exclusionIdstring

        Stable identifier of the exclusion; same update semantics as inclusionId.

        Example:
        64a1f0c2e4b0a1b2c3d4e5f7
    • imagesobject[]

      Experience photos.

      Child fields
      • urlHighstring (uri)

        High-resolution image URL (Cloudinary URLs are normalized on write).

        Example:
        https://res.cloudinary.com/turneo/image/upload/hi.jpg
      • urlLowstring (uri)nullable

        Low-resolution/thumbnail image URL.

        Example:
        https://res.cloudinary.com/turneo/image/upload/lo.jpg
      • altTextstringnullable

        Accessibility alt text for the image.

        Example:
        Kayaks lined up at sunset
    • externalLinksobject[]

      Links to external systems (external IDs, booking links).

      Child fields
      • idstring (uuid)

        Link ID.

        Example:
        3f1c2b4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d
      • typestring

        Link type (e.g. EXTERNAL_ID, BOOKING_LINK).

        Example:
        EXTERNAL_ID
      • namestring

        Display label for the link. May be blank.

        Example:
        Bokun activity ID
      • valuestring

        The URL or external identifier.

        Example:
        1189606
    • bookingTypestring

      EXTERNAL when a BOOKING_LINK external link exists (booked off-platform), else INTERNAL.

      Allowed values:
      INTERNALEXTERNAL
      Example:
      INTERNAL
    • participantTypesobject[]

      Active participant types, ordered by sortOrder.

      Child fields
      • idstring (uuid)

        Participant type ID.

        Example:
        6d7e8f9a-0b1c-4d2e-8f3a-4b5c6d7e8f9a
      • experienceIdstring (uuid)

        ID of the owning experience.

        Example:
        5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • descriptionstring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • minAgeintegernullable

        Minimum age for this participant type.

        Example:
        18
      • maxAgeintegernullable

        Maximum age for this participant type.

        Example:
        99
      • capacityExemptboolean

        When true, participants of this type do not count toward slot capacity.

        Example:
        false
      • sortOrderinteger

        Display order (ascending).

        Example:
        0
      • isDefaultboolean

        True for the auto-created Adult/Child/Infant types (cannot be deleted).

        Example:
        true
      • externalIdstringnullable

        Provider-side identifier for externally synced participant types.

        Example:
        BOKUN-ADULT
      • isEnabledOnBookableOptionsboolean

        True when this type is offered on at least one option a guest can actually book going forward (active, non-custom option with a future bookable availability slot that does not disable this type).

        Example:
        true
    • optionsobject[]

      Only present on retrieve when includeOptions=1 is passed — absent otherwise (including on list responses). Same item shape and filtering as the /options sub-endpoint.

      Child fields
      • idstring (uuid)

        Option ID.

        Example:
        9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f
      • statusstring

        Option status. Embedded lists default to ACTIVE options only.

        Allowed values:
        DRAFTACTIVEINACTIVE
        Example:
        ACTIVE
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

    • tagsobjectnullable

      Computed marketing tags. exclusive/private are recalculated from the current options and allowedPartners on every read; the remaining flags come from stored data.

      Child fields
      • likelyToSellOutboolean

        Whether the experience is flagged as likely to sell out.

        Example:
        false
      • popularboolean

        Whether the experience is flagged as popular.

        Example:
        true
      • exclusiveboolean

        True when the experience is shared with exactly one partner.

        Example:
        false
      • privatestring

        Private-group availability across active options — NO (no private options), YES (mix of private and shared), ONLY_PRIVATE (all options are private).

        Allowed values:
        NOYESONLY_PRIVATE
        Example:
        NO
    • localizedobject[]nullable

      Translation completeness per language, or null when nothing is translated. Non-owners only see complete (ACTIVE) languages; the owner also sees incomplete (DRAFT) ones.

      Child fields
      • languagestring

        2-letter language code.

        Example:
        de
      • statusstring

        ACTIVE when every translatable field across the experience, inclusions, category themes, participant types and active options/variants/add-ons is translated; DRAFT (owner-only) when a partial translation exists.

        Allowed values:
        ACTIVEDRAFT
        Example:
        ACTIVE
      • sourcestring

        Whether the translation is fully machine-generated or contains organizer-authored text.

        Allowed values:
        AIORGANIZER
        Example:
        ORGANIZER
    • reviewsobjectnullable

      Aggregated traveler reviews. null when the experience has no (visible) reviews. By default only ACCEPTED reviews are included; pass unapproved_reviews=true to include the rest. Reviews are ordered by rating, then insightfulness.

      Child fields
      • recommendedPercentinteger

        Percentage of visible reviews rated 3 stars or higher.

        Example:
        96
      • ratingnumber (double)

        Average rating across visible reviews, rounded to one decimal.

        Example:
        4.8
      • summarystringnullable

        AI-generated summary of the reviews, when available.

        Example:
        Guests consistently praise the guides and the sunset views.
      • reviewsobject[]

        The individual reviews.

        Child fields
        • ratinginteger

          Star rating (1-5).

          Example:
          5
        • reviewTextstringnullable

          Review text, translated to the requested language when a translation exists.

          Example:
          Fantastic sunset tour, our guide was brilliant.
        • reviewerNamestringnullable

          Reviewer display name; falls back to the booking's traveler first name.

          Example:
          Anna
        • datestring

          Review date (ISO 8601).

          Example:
          2026-05-14T18:03:00
        • sourcestring

          RESELLER when the requesting partner posted the review themselves, OTHER otherwise.

          Example:
          OTHER
        • storeIdstringnullable

          Store the review was posted from — only exposed for the poster's own reviews, null otherwise.

          Example:
          64a1f0c2e4b0a1b2c3d4e5f6
        • statusstring

          Moderation status. Non-ACCEPTED reviews appear only with unapproved_reviews=true.

          Allowed values:
          PENDINGACCEPTEDREJECTED
          Example:
          ACCEPTED
        • insightfulnessScorenumber (double)nullable

          AI-scored insightfulness, used for ordering reviews.

          Example:
          0.87
    • discountobjectnullable

      The single highest currently valid discount across all active, non-custom options — either an availability discount or an early-bird discount. null when no discount applies or when availability comes from an external provider.

      Child fields
      • percentageAmountnumber (double)

        Discount percentage.

        Example:
        15
      • typestring

        Which kind of discount is the highest.

        Allowed values:
        AVAILABILITYEARLY_BIRD
        Example:
        AVAILABILITY
    • propertyIdstring (uuid)nullable

      UUID of the property (hotel) associated with this experience, if any.

      Example:
      8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b
    • retailAttributesobject[]nullable

      The variation axes of a RETAIL or VOUCHER product, on GET /v2/experiences/{id} only. Null on list rows and on bookable experiences.

      Child fields
      • idstring (uuid)

        Axis UUID.

        Example:
        2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e
      • namestring or map of string

        Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

        Accepted shapes
        • Either string

        • Or map of string

      • sortOrderinteger

        Position of the axis among the product's axes.

        Example:
        0
      • valuesobject[]

        The axis's values, in sortOrder.

        Child fields
        • idstring (uuid)

          Value UUID. SKUs list the values they are made of in attributeValueIds.

          Example:
          9a8b7c6d-5e4f-4a3b-8c1d-0e9f8a7b6c5d
        • labelstring or map of string

          Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

          Accepted shapes
          • Either string

          • Or map of string

        • sortOrderinteger

          Position of the value within its axis.

          Example:
          0
    • retailSkusobject[]nullable

      The SKUs a shopper can buy, with live availability, for a RETAIL or VOUCHER product on GET /v2/experiences/{id} only. Null on list rows and on bookable experiences.

      Child fields
      • idstring (uuid)

        SKU UUID. Send it as retailSkuId to buy this SKU on an order.

        Example:
        8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d
      • skuCodestringnullable

        The seller's stock-keeping code for this SKU.

        Example:
        TSHIRT-RED-M
      • attributeValueIdsstring (uuid)[]

        The variation values this SKU is made of; match them against retailAttributes to label it.

      • sortOrderinteger

        Display position.

        Example:
        0
      • pricestring

        Unit price as a decimal string, in the organizer's default currency.

        Example:
        24.00
      • availableQuantityintegernullable

        Units available to buy now (on hand minus units held in unconfirmed orders). Null means unlimited.

        Example:
        3
      • extraFieldsobject[]

        Questions the buyer answers when buying this SKU.

        Child fields
        • idstring (uuid)

          Question UUID. Answers are keyed by it.

          Example:
          aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f
        • namestring or map of string

          Multilingual text field. Stored as an object keyed by language code (en, de, it, es, fr, hr, sl, pt, zh, zh-hant, ja, ko, ru; machine translations are stored under <lang>_auto keys internally). On read it is returned as a single string resolved for the requested language (falling back to English when the object is not consistently translated), or as the full per-language object when showTranslations=true is passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.

          Accepted shapes
          • Either string

          • Or map of string

        • sortOrderinteger

          Order the questions are asked in.

          Example:
          0
        • fieldTypestring

          QUESTION takes free text; CHECKBOX takes "true" or "false".

          Allowed values:
          QUESTIONCHECKBOX
          Example:
          QUESTION
        • requiredboolean

          Whether the question must be answered before the order can be confirmed. A required CHECKBOX must be ticked.

          Example:
          false
      • imageUrlstring (uri)nullable

        The SKU's own image, or null when it has none.

        Example:
        https://images.example.com/tshirt-red.jpg
    • retailVoucherConfigobjectnullable

      Redemption rules of a VOUCHER product, on GET /v2/experiences/{id} only. Null otherwise, and while no rules are set.

      Child fields
      • redemptionsPerUnitinteger

        How many uses one voucher grants. One use covers one booking.

        Limits:
        minimum 1
        Example:
        5
      • scopeExperienceIdsstring (uuid)[]

        The experiences the voucher can be redeemed against.

      • includesAddonboolean

        Whether a redeemed booking may include one add-on of its option at no charge.

        Example:
        false
Response 200json
{
  "count": 137,
  "next": "https://api.turneo.co/v2/experiences?page=2&page_size=50",
  "previous": null,
  "results": [
    {
      "id": "5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b",
      "name": "Sunset Kayak Tour",
      "description": "Sunset Kayak Tour",
      "highlight": "Sunset Kayak Tour",
      "otherNotes": "Sunset Kayak Tour",
      "noReservationNote": "Sunset Kayak Tour",
      "code": "KAYAK-01",
      "status": "ACTIVE",
      "experienceType": "EXPERIENCE",
      "organizer": {
        "name": "Acme Tours",
        "partnerId": "acme-tours",
        "phone": "+385911234567",
        "partnerEmail": "hello@acmetours.com",
        "partnerRating": 4.8,
        "partnerReviews": 132,
        "logo": "https://res.cloudinary.com/turneo/image/upload/logo.png",
        "website": "https://acmetours.com",
        "aboutUs": "Family-run kayak outfitter since 2005.",
        "supportEmail": "support@acmetours.com",
        "featureFlags": {}
      },
      "categories": {
        "type": "Water sports"
      },
      "categoryThemes": [
        {
          "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
          "name": "Sunset Kayak Tour",
          "nameDefault": "Family friendly",
          "isDefault": false,
          "description": "Great for kids of all ages."
        }
      ],
      "location": {
        "city": "Split",
        "country": "Croatia",
        "address": "Riva 1",
        "latitude": 43.508,
        "longitude": 16.44,
        "description": "Next to the ferry terminal."
      },
      "meetingPoint": null,
      "meetingPoints": [
        {
          "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
          "type": "CENTRAL_MEETING_POINT",
          "city": "Split",
          "country": "Croatia",
          "address": "Riva 1",
          "description": "Look for the yellow flag.",
          "latitude": 43.508,
          "longitude": 16.44,
          "timeBeforeStart": 15,
          "title": "Riva promenade"
        }
      ],
      "pickup": {
        "value": "Hotel pickup available",
        "rules": "Within 5 km of the city center only."
      },
      "allowFreePickup": true,
      "duration": {
        "days": 0,
        "hours": 2,
        "minutes": 30
      },
      "rating": null,
      "videos": [
        "https://youtube.com/watch?v=abc123"
      ],
      "maxPrice": {
        "amount": 79,
        "freeOfCharge": false,
        "public": {
          "amount": 99,
          "unit": "Person",
          "freeOfCharge": false
        },
        "private": {
          "amount": 99,
          "unit": "Person",
          "freeOfCharge": false
        },
        "currency": "EUR",
        "unit": "person"
      },
      "minPrice": {
        "amount": 79,
        "freeOfCharge": false,
        "public": {
          "amount": 99,
          "unit": "Person",
          "freeOfCharge": false
        },
        "private": {
          "amount": 99,
          "unit": "Person",
          "freeOfCharge": false
        },
        "currency": "EUR",
        "unit": "person"
      },
      "languages": "English,German",
      "cutOffTime": 4,
      "refundPolicy": {
        "tiers": [
          {
            "hoursBeforeStart": 48,
            "refundPercentage": 100
          }
        ]
      },
      "supportContact": [
        {
          "type": "email",
          "value": "support@acmetours.com"
        }
      ],
      "travellerTypeScores": {
        "families": 0.9,
        "couples": 0.7
      },
      "availableFrom": "2026-09-01",
      "publishedAt": "2026-04-02T09:15:00Z",
      "commission": 20,
      "commissionSettings": [
        {
          "id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
          "type": "MARKETPLACE",
          "reseller": "grand-hotel",
          "value": 20
        }
      ],
      "included": [
        {
          "name": "Sunset Kayak Tour",
          "inclusionId": "64a1f0c2e4b0a1b2c3d4e5f6"
        }
      ],
      "excluded": [
        {
          "name": "Sunset Kayak Tour",
          "exclusionId": "64a1f0c2e4b0a1b2c3d4e5f7"
        }
      ],
      "images": [
        {
          "urlHigh": "https://res.cloudinary.com/turneo/image/upload/hi.jpg",
          "urlLow": "https://res.cloudinary.com/turneo/image/upload/lo.jpg",
          "altText": "Kayaks lined up at sunset"
        }
      ],
      "externalLinks": [
        {
          "id": "3f1c2b4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d",
          "type": "EXTERNAL_ID",
          "name": "Bokun activity ID",
          "value": "1189606"
        }
      ],
      "bookingType": "INTERNAL",
      "participantTypes": [
        {
          "id": "6d7e8f9a-0b1c-4d2e-8f3a-4b5c6d7e8f9a",
          "experienceId": "5f8b8c1e-3f8a-4a1e-9d2b-1c2d3e4f5a6b",
          "name": "Sunset Kayak Tour",
          "description": "Sunset Kayak Tour",
          "minAge": 18,
          "maxAge": 99,
          "capacityExempt": false,
          "sortOrder": 0,
          "isDefault": true,
          "externalId": "BOKUN-ADULT",
          "isEnabledOnBookableOptions": true
        }
      ],
      "options": [
        {
          "id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
          "status": "ACTIVE",
          "name": "Sunset Kayak Tour"
        }
      ],
      "tags": {
        "likelyToSellOut": false,
        "popular": true,
        "exclusive": false,
        "private": "NO"
      },
      "localized": [
        {
          "language": "de",
          "status": "ACTIVE",
          "source": "ORGANIZER"
        }
      ],
      "reviews": {
        "recommendedPercent": 96,
        "rating": 4.8,
        "summary": "Guests consistently praise the guides and the sunset views.",
        "reviews": [
          {
            "rating": 5,
            "reviewText": "Fantastic sunset tour, our guide was brilliant.",
            "reviewerName": "Anna",
            "date": "2026-05-14T18:03:00",
            "source": "OTHER",
            "storeId": "64a1f0c2e4b0a1b2c3d4e5f6",
            "status": "ACCEPTED",
            "insightfulnessScore": 0.87
          }
        ]
      },
      "discount": {
        "percentageAmount": 15,
        "type": "AVAILABILITY"
      },
      "propertyId": "8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b",
      "retailAttributes": [
        {
          "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
          "name": "Sunset Kayak Tour",
          "sortOrder": 0,
          "values": [
            {
              "id": "9a8b7c6d-5e4f-4a3b-8c1d-0e9f8a7b6c5d",
              "label": "Sunset Kayak Tour",
              "sortOrder": 0
            }
          ]
        }
      ],
      "retailSkus": [
        {
          "id": "8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d",
          "skuCode": "TSHIRT-RED-M",
          "attributeValueIds": [
            "9a8b7c6d-5e4f-4a3b-8c1d-0e9f8a7b6c5d"
          ],
          "sortOrder": 0,
          "price": "24.00",
          "availableQuantity": 3,
          "extraFields": [
            {
              "id": "aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f",
              "name": "Sunset Kayak Tour",
              "sortOrder": 0,
              "fieldType": "QUESTION",
              "required": false
            }
          ],
          "imageUrl": "https://images.example.com/tshirt-red.jpg"
        }
      ],
      "retailVoucherConfig": {
        "redemptionsPerUnit": 5,
        "scopeExperienceIds": [
          "0d4dbb2e-8a51-4a4b-9d3e-6f2b7c1a9e55"
        ],
        "includesAddon": false
      }
    }
  ]
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}