Semantic experience search within a store

GET/v2/experiences/search

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

Free-text semantic search over the experiences assigned to one store, backed by the AI agents service. Intended for storefront search boxes.

The store is identified by the x-store-id request header (required — missing header returns 400). The AI service returns matching experience IDs, which are then serialized with the public experience read shape.

Returns 404 when the search produces no matches — treat 404 as "no results", not as a missing route. The summary field is reserved for a future version of the semantic search and is currently always null.

Requestbash
curl "https://api.turneo.co/v2/experiences/search?term=romantic%20dinner%20on%20the%20water&language=en" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • termstringrequired

    The search phrase. Required — missing values return 400.

    Example:
    romantic dinner on the water
  • languagestringrequired

    Language code of the search term and of the localized response fields. Required.

    Example:
    en

Header parameters

  • x-store-idstringrequired

    ID of the store whose assigned experiences are searched.

    Example:
    64a1f0c2e4b0a1b2c3d4e5f6

Responses

200object

Matching experiences.

  • summarystringnullable

    Reserved for a future search version — currently always null.

  • experiencesobject[]

    Experiences matched by the AI search, in relevance order.

    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
{
  "summary": null,
  "experiences": [
    {
      "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.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

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."
    }
  ]
}