List options of an experience

GET/v2/experiences/{experienceId}/options

Requires your API key in the X-API-Key header.

Returns the options of an experience, ordered by the organizer's sort order. Reads are public: any authenticated API-key caller may list options of an experience.

Status filtering

Defaults to ACTIVE options only. Pass a comma-separated list (?status=ACTIVE,INACTIVE) to widen it, or repeat the parameter (?status=ACTIVE&status=INACTIVE); any value outside DRAFT/ACTIVE/INACTIVE is a 400. The filter applies to the list action only — a DRAFT or INACTIVE option can still be fetched directly by id.

Variant visibility

restricted=false returns only public variants; restricted=true returns the restricted (member-only) variants, falling back to public ones when the option has none. Omitted, all active variants are returned.

Localization

Multilingual fields (name, note, and nested variant/add-on/extra-field names) are returned as full language objects ({"en": ..., "de": ...}). Pass ?language=de to collapse them to plain strings in that language.

Requestbash
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f

Query parameters

  • statusstring

    Comma-separated option statuses to include. Defaults to ACTIVE when omitted. Invalid values return a 400 listing the allowed statuses.

    Example:
    ACTIVE,INACTIVE
  • restrictedboolean

    Variant visibility filter. false — public variants only; true — restricted (member-only) variants, falling back to public ones when the option has no active restricted variants; omitted — no filtering. Any value other than true is treated as false.

    Example:
    false
  • languagestring

    Two-letter language code. When present, multilingual fields collapse from full language objects to plain strings in that language.

    Example:
    de
  • pageinteger

    Page number (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Items per page (default 50). Note the snake_case wire name.

    Default:
    50
    Example:
    50
  • nopaginationboolean

    Set to true to disable pagination and return the bare array of results.

    Default:
    false
    Example:
    false

Responses

200object

Paginated list of options.

  • countinteger

    Total number of options matching the filters.

    Example:
    3
  • nextstringnullable

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

  • previousstringnullable

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

  • resultsobject[]

    Options on this page, ordered by score ascending.

    Child fields
    • idstring (uuid)

      Option id.

      Example:
      3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
    • experienceIdstring (uuid)read-only

      The parent experience id (always the experience in the URL).

      Example:
      8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
    • statusstring

      Lifecycle status. Only ACTIVE options are sellable and generate availability slots. An option can never return to DRAFT once it has been ACTIVE or INACTIVE.

      Allowed values:
      DRAFTACTIVEINACTIVE
      Example:
      ACTIVE
    • namemap of stringnullable

      Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

    • codestringnullable

      Free-form organizer reference code.

      Example:
      KAYAK-AM
    • scoreinteger

      Sort weight (ascending). Auto-assigned to the bottom on create when omitted; deactivated/deleted options are pushed to the bottom automatically.

      Example:
      100
    • externalIdstringnullableread-only

      External provider identifier when the option is synced from Bokun/Regiondo/Kompas. Externally-synced options cannot be mutated through this API.

    • notemap of stringnullable

      Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

    • instantUntilDurationobjectnullable

      Booking confirmation threshold. null = every booking needs manual organizer confirmation; an all-zero duration = always instant; a positive duration = instant only when booked further in advance than this threshold.

      Child fields
      • daysinteger

        Whole days component.

        Example:
        0
      • hoursinteger

        Hours component.

        Example:
        2
      • minutesinteger

        Minutes component.

        Example:
        30
    • disabledParticipantTypesstring (uuid)[]

      IDs of the experience's participant types that are NOT bookable on this option. Empty means all types are enabled.

    • startDatestring (date)nullable

      First sellable date. Required for ACTIVE options.

      Example:
      2026-07-01
    • endDatestring (date)nullable

      Last sellable date. null means open-ended.

      Example:
      2026-09-30
    • slotTypestringnullable

      How slots are generated: FLEXIBLE (a time window at a regular interval), FIXED (explicit start times per weekday) or DATE_ONLY (whole-day slots with no start time). Required for ACTIVE options.

      Allowed values:
      FLEXIBLEFIXEDDATE_ONLYnull
      Example:
      FIXED
    • flexibleSlotConfigobjectnullable

      FLEXIBLE schedule config. Required for FLEXIBLE, must be empty otherwise. fromTime after toTime describes an overnight window.

      Child fields
      • fromTimestring

        Window start, HH:MM local time.

        Example:
        08:00
      • toTimestring

        Window end, HH:MM local time.

        Example:
        18:00
      • intervalstring

        Step between generated slots, HH:MM.

        Example:
        00:30
      • daysOfWeekinteger[]

        Weekdays slots are generated for (0=Monday … 6=Sunday). Must be non-empty.

    • fixedSlotConfigobject[]nullable

      FIXED schedule config — explicit start times per set of weekdays. Required for FIXED, must be empty otherwise.

      Child fields
      • timestring

        Slot start time, HH:MM local.

        Example:
        09:00
      • daysOfWeekinteger[]

        Weekdays this start time applies to (0=Monday … 6=Sunday). Must be non-empty.

    • groupTypestringnullable

      Whether a booked resource is private to one party or shared. Required when resource groups are configured; must be empty otherwise.

      Allowed values:
      PRIVATEPUBLICnull
    • slotCapacityintegernullable

      Participants per slot. Ignored (auto-nulled) when resource groups drive capacity. Individual slots can cap it further via capacityOverride.

      Example:
      10
    • pricingModelstringnullable

      How variant prices are computed. Required for ACTIVE options. On a non-DRAFT option the model cannot be switched to or from DURATION_BASED.

      Allowed values:
      FLAT_RATEPER_PERSONPER_GROUP_SIZEDURATION_BASEDnull
      Example:
      PER_PERSON
    • durationobjectnullable

      Fixed duration of one booking (FLAT_RATE / PER_PERSON / PER_GROUP_SIZE). Optional in general, but required (non-zero) for timed options with resource groups; must be empty for DURATION_BASED.

      Child fields
      • daysinteger

        Whole days component.

        Example:
        0
      • hoursinteger

        Hours component.

        Example:
        2
      • minutesinteger

        Minutes component.

        Example:
        30
    • durationIncrementobjectnullable

      DURATION_BASED only: the bookable time increment. Guests book N multiples of it (e.g. increment 30 minutes, 3 units = 90 minutes). Required non-zero for DURATION_BASED; must be empty otherwise.

      Child fields
      • daysinteger

        Whole days component.

        Example:
        0
      • hoursinteger

        Hours component.

        Example:
        2
      • minutesinteger

        Minutes component.

        Example:
        30
    • durationPricingUnitstringnullable

      UI-only hint for DURATION_BASED options: whether the per-increment price scales by headcount or is flat per resource. Not used by backend pricing.

      Allowed values:
      PER_PERSONPER_RESOURCEnull
    • multiDayModestringnullable

      For rentals of one day or more: how the rental window ends. CALENDAR_DAY (default) — until the Nth rental day's working-hours close; ROLLING_24H — N × 24h from the start instant. Ignored for sub-day options.

      Allowed values:
      ROLLING_24HCALENDAR_DAYnull
      Example:
      CALENDAR_DAY
    • allowPartialDayboolean

      Fixed-duration options with resources only: when true, a booking whose full duration does not fit the remaining working hours of the day is accepted clamped to closing time, at the unchanged fixed price ("up to N hours" day passes). Not applicable to DURATION_BASED or multi-day options.

      Example:
      false
    • customboolean

      True for one-off options auto-created for a specific custom booking. Custom options are excluded from public catalog queries and availability.

      Example:
      false
    • earlyBirdAdvanceDaysintegernullable

      Days in advance a booking must be made to earn the early-bird discount. Must be set together with earlyBirdDiscount.

      Example:
      30
    • earlyBirdDiscountstringnullable

      Early-bird discount percentage, decimal string. Set together with earlyBirdAdvanceDays.

      Example:
      15.00
    • variantsobject[]

      Active variants, filtered by the restricted query parameter when present.

      Child fields
      • idstring (uuid)

        Variant id. Omit on create; include on update to modify in place.

        Example:
        4c9c2ab7-9a1d-4b8a-b6a0-5f2f8d3f7e21
      • namemap of stringnullable

        Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

      • imagestringnullable

        URL of an illustrative image for the variant.

        Example:
        https://cdn.turneo.com/variants/premium.jpg
      • maxParticipantsintegernullable

        Maximum capacity-relevant participants this variant can hold per booking. null means unlimited.

        Example:
        8
      • sortOrderinteger

        Display position among the option's variants (ascending).

        Example:
        0
      • flatPricestringnullable

        Flat price per booking, decimal string. Only for FLAT_RATE pricing.

        Example:
        150.00
      • groupSizeUnitstringnullable

        How PER_GROUP_SIZE tier prices are applied — per person in the group or once per group. Only for PER_GROUP_SIZE pricing.

        Allowed values:
        PER_PERSONPER_GROUPnull
        Example:
        PER_GROUP
      • pricingTiersobject[]

        Graduated price bands (PER_GROUP_SIZE / DURATION_BASED pricing). Active tiers only on reads.

        Child fields
        • idstring (uuid)

          Tier id. Omit on create; include on update to modify an existing tier.

          Example:
          0f6f9a3a-4a1a-4a90-9c39-2f1d1a9c1a11
        • minQuantityinteger

          Inclusive lower bound of the band. The first tier must start at 1.

          Example:
          1
        • maxQuantityintegernullable

          Inclusive upper bound of the band. null makes the tier open-ended ("7+"); only the last tier may be open-ended.

          Example:
          6
        • pricestring

          Price for this band as a decimal string, in the experience currency.

          Example:
          120.00
      • participantPricesobject[]

        Per-participant-type prices (PER_PERSON pricing). Active prices only on reads.

        Child fields
        • idstring (uuid)

          Price row id. Omit on create; include on update.

          Example:
          61a3a9a2-1a7e-4a53-8f0a-6f0f4d1c2b33
        • participantTypeIdstring (uuid)

          The participant type this price applies to. Must be a type of the same experience.

          Example:
          a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
        • pricestring

          Price per participant of this type, decimal string.

          Example:
          45.00
      • restrictedboolean

        Marks the variant as exclusive/member-only. Restricted variants are hidden or surfaced by the restricted query parameter on reads and the availability endpoints.

        Example:
        false
    • addonsobject[]

      Active add-ons.

      Child fields
      • idstring (uuid)

        Add-on id. Omit on create; include on update.

        Example:
        5b1f7d64-3f8a-4f4c-8f0e-9e9a2b7c1d55
      • namemap of stringnullable

        Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

      • sortOrderinteger

        Display position (ascending).

        Example:
        0
      • addonTypestring

        UI behaviour — a simple yes/no checkbox or a quantity selector.

        Allowed values:
        CHECKBOXQUANTITY_SELECTOR
        Example:
        QUANTITY_SELECTOR
      • perPersonboolean

        When true, the add-on price/quantity applies per participant instead of per booking.

        Example:
        false
      • maxQuantityintegernullable

        Maximum quantity selectable (QUANTITY_SELECTOR). null means no cap.

        Example:
        5
      • pricestringnullable

        Price per unit, decimal string. null means free.

        Example:
        12.00
      • nonCommissionableboolean

        When true, the add-on amount is excluded from commission calculations.

        Example:
        false
    • extraFieldsobject[]

      Active extra booking fields.

      Child fields
      • idstring (uuid)

        Field id. Omit on create; include on update.

        Example:
        9d2b1c33-7e6a-4b2f-a1c4-3f5d6e7a8b90
      • namemap of stringnullable

        Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

      • sortOrderinteger

        Display position (ascending).

        Example:
        0
      • fieldTypestring

        Free-text question or boolean checkbox.

        Allowed values:
        QUESTIONCHECKBOX
        Example:
        QUESTION
      • requiredboolean

        Whether the guest must answer before the booking can be placed.

        Example:
        true
    • discountsobject[]

      Active scheduled discounts.

      Child fields
      • idstring (uuid)

        Discount id. Omit on create; include on update.

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

        Discount percentage as a decimal string.

        Example:
        10.00
      • startDatestring (date)nullable

        First slot date the discount applies to.

        Example:
        2026-07-01
      • endDatestring (date)nullable

        Last slot date the discount applies to.

        Example:
        2026-07-31
      • fromTimestringnullable

        Earliest slot start time the discount applies to, HH:MM[:SS] local.

        Example:
        09:00
      • untilTimestringnullable

        Latest slot start time the discount applies to, HH:MM[:SS] local.

        Example:
        12:00
      • daysOfWeekinteger[]nullable

        Weekdays the discount applies to (0=Monday … 6=Sunday).

    • resourceGroupsobject[]

      Active resource groups, with read-only resourceDetails expansion.

      Child fields
      • idstring (uuid)

        Group id. Omit on create; include on update.

        Example:
        2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f
      • namestringnullable

        Organizer-facing group label.

        Example:
        Kayaks
      • resourcesstring (uuid)[]

        IDs of the resources in this group.

      • resourceDetailsobject[]read-only

        Read-only expansion of the group's resources.

        Child fields
        • idstring (uuid)

          Resource id.

          Example:
          c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f
        • namestring

          Resource name.

          Example:
          Kayak 1
        • capacityintegernullable

          Maximum participants the resource can hold (its maxParticipants).

          Example:
          2
Response 200json
{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6",
      "experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
      "status": "ACTIVE",
      "name": {
        "en": "Shared boat tour",
        "de": "Gemeinsame Bootstour"
      },
      "code": "KAYAK-AM",
      "score": 100,
      "externalId": null,
      "note": {
        "en": "Shared boat tour",
        "de": "Gemeinsame Bootstour"
      },
      "instantUntilDuration": {
        "days": 0,
        "hours": 2,
        "minutes": 30
      },
      "disabledParticipantTypes": [],
      "startDate": "2026-07-01",
      "endDate": "2026-09-30",
      "slotType": "FIXED",
      "flexibleSlotConfig": {
        "fromTime": "08:00",
        "toTime": "18:00",
        "interval": "00:30",
        "daysOfWeek": [
          0,
          1,
          2,
          3,
          4
        ]
      },
      "fixedSlotConfig": [
        {
          "time": "09:00",
          "daysOfWeek": [
            5,
            6
          ]
        }
      ],
      "groupType": null,
      "slotCapacity": 10,
      "pricingModel": "PER_PERSON",
      "duration": {
        "days": 0,
        "hours": 2,
        "minutes": 30
      },
      "durationIncrement": {
        "days": 0,
        "hours": 2,
        "minutes": 30
      },
      "durationPricingUnit": null,
      "multiDayMode": "CALENDAR_DAY",
      "allowPartialDay": false,
      "custom": false,
      "earlyBirdAdvanceDays": 30,
      "earlyBirdDiscount": "15.00",
      "variants": [
        {
          "id": "4c9c2ab7-9a1d-4b8a-b6a0-5f2f8d3f7e21",
          "name": {
            "en": "Shared boat tour",
            "de": "Gemeinsame Bootstour"
          },
          "image": "https://cdn.turneo.com/variants/premium.jpg",
          "maxParticipants": 8,
          "sortOrder": 0,
          "flatPrice": "150.00",
          "groupSizeUnit": "PER_GROUP",
          "pricingTiers": [
            {
              "id": "0f6f9a3a-4a1a-4a90-9c39-2f1d1a9c1a11",
              "minQuantity": 1,
              "maxQuantity": 6,
              "price": "120.00"
            }
          ],
          "participantPrices": [
            {
              "id": "61a3a9a2-1a7e-4a53-8f0a-6f0f4d1c2b33",
              "participantTypeId": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
              "price": "45.00"
            }
          ],
          "restricted": false
        }
      ],
      "addons": [
        {
          "id": "5b1f7d64-3f8a-4f4c-8f0e-9e9a2b7c1d55",
          "name": {
            "en": "Shared boat tour",
            "de": "Gemeinsame Bootstour"
          },
          "sortOrder": 0,
          "addonType": "QUANTITY_SELECTOR",
          "perPerson": false,
          "maxQuantity": 5,
          "price": "12.00",
          "nonCommissionable": false
        }
      ],
      "extraFields": [
        {
          "id": "9d2b1c33-7e6a-4b2f-a1c4-3f5d6e7a8b90",
          "name": {
            "en": "Shared boat tour",
            "de": "Gemeinsame Bootstour"
          },
          "sortOrder": 0,
          "fieldType": "QUESTION",
          "required": true
        }
      ],
      "discounts": [
        {
          "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
          "percentageAmount": "10.00",
          "startDate": "2026-07-01",
          "endDate": "2026-07-31",
          "fromTime": "09:00",
          "untilTime": "12:00",
          "daysOfWeek": [
            0,
            1,
            2,
            3,
            4
          ]
        }
      ],
      "resourceGroups": [
        {
          "id": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f",
          "name": "Kayaks",
          "resources": [
            "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f"
          ],
          "resourceDetails": [
            {
              "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
              "name": "Kayak 1",
              "capacity": 2
            }
          ]
        }
      ]
    }
  ]
}

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