Retrieve an option

GET/v2/experiences/{experienceId}/options/{optionId}

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

Returns a single option by id. Unlike the list endpoint, this resolves options in any status (DRAFT/ACTIVE/INACTIVE) so organizers can keep managing unpublished options. The restricted and language query parameters behave exactly as on the list endpoint. Returns 404 for soft-deleted options or options belonging to a different experience.

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

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • optionIdstring (uuid)required

    UUID of the option (must belong to the experience in the path).

    Example:
    3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6

Query parameters

  • 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

Responses

200object

The option.

  • 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
{
  "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

401

Missing or invalid X-API-Key header.

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 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}