Partially update an option

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

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

Partial update of an option. Identical semantics to PUT (organizer-only, rejected on externally-sourced experiences, status rules, by-id reconciliation of nested arrays, slot regeneration) but only the supplied fields are touched. Note that supplying a nested array still reconciles it fully: to update one variant without deleting its siblings, include all active variants (existing ones by id).

Requestbash
curl -X PATCH "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options/3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "INACTIVE"
  }'

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

Request bodyapplication/json, required

  • statusstring

    Lifecycle status; defaults to DRAFT on create. Non-DRAFT saves run full activation validation, except that an existing ACTIVE option may always be deactivated to INACTIVE. Reverting to DRAFT is rejected.

    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; auto-assigned to the bottom when omitted on create.

    Example:
    300
  • 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 (see read shape).

    Child fields
    • daysinteger

      Whole days component.

      Example:
      0
    • hoursinteger

      Hours component.

      Example:
      2
    • minutesinteger

      Minutes component.

      Example:
      30
  • disabledParticipantTypesstring (uuid)[]

    Participant type IDs to disable on this option. All IDs must belong to this experience (400 otherwise).

  • participantTypesobject[]

    Optional full desired active participant-type state, reconciled atomically with the option. Omit this field to leave participant types untouched. When supplied, every active default type must be present; omitted custom types are soft-deleted. Existing IDs update rows, while unknown client-generated UUIDs create custom types. Default types accept only id, minAge, maxAge, and capacityExempt. disabledParticipantTypes may reference UUIDs created in the same request and represents the final disabled state for this option.

    Child fields
    • idstring (uuid)required
    • 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.

    • descriptionmap 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.

    • minAgeintegernullable
    • maxAgeintegernullable
    • capacityExemptboolean
    • sortOrderinteger
  • startDatestring (date)nullable

    First sellable date. Required for ACTIVE options. Changing it regenerates slots.

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

    Last sellable date; must not be before startDate. Changing it regenerates slots.

    Example:
    2026-09-30
  • slotTypestringnullable

    Slot generation mode. Changing it regenerates slots.

    Allowed values:
    FLEXIBLEFIXEDDATE_ONLYnull
    Example:
    FIXED
  • flexibleSlotConfigobjectnullable

    FLEXIBLE schedule config (see read shape). Changing it regenerates slots.

    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 (0=Monday … 6=Sunday), non-empty.

  • fixedSlotConfigobject[]nullable

    FIXED schedule config (see read shape). Changing it regenerates slots.

    Child fields
    • timestring

      Slot start time, HH:MM local.

      Example:
      09:00
    • daysOfWeekinteger[]

      Weekdays (0=Monday … 6=Sunday), non-empty.

  • groupTypestringnullable

    Required when resource groups are configured; empty otherwise.

    Allowed values:
    PRIVATEPUBLICnull
  • slotCapacityintegernullable

    Participants per slot; auto-nulled when resource groups are configured.

    Example:
    10
  • pricingModelstringnullable

    Pricing model. On non-DRAFT options, switching to or from DURATION_BASED is rejected — create a new option instead.

    Allowed values:
    FLAT_RATEPER_PERSONPER_GROUP_SIZEDURATION_BASEDnull
    Example:
    PER_PERSON
  • durationobjectnullable

    Fixed booking duration (non-DURATION_BASED models).

    Child fields
    • daysinteger

      Whole days component.

      Example:
      0
    • hoursinteger

      Hours component.

      Example:
      2
    • minutesinteger

      Minutes component.

      Example:
      30
  • durationIncrementobjectnullable

    Bookable increment (DURATION_BASED only).

    Child fields
    • daysinteger

      Whole days component.

      Example:
      0
    • hoursinteger

      Hours component.

      Example:
      2
    • minutesinteger

      Minutes component.

      Example:
      30
  • durationPricingUnitstringnullable

    UI-only pricing-unit hint for DURATION_BASED options.

    Allowed values:
    PER_PERSONPER_RESOURCEnull
  • multiDayModestringnullable

    Rental-window end semantics for multi-day options.

    Allowed values:
    ROLLING_24HCALENDAR_DAYnull
    Example:
    CALENDAR_DAY
  • allowPartialDayboolean

    Accept clamped "rest of the working day" bookings on fixed-duration resource-backed options. Rejected on DURATION_BASED options, options without resource groups, and multi-day durations.

    Example:
    false
  • customboolean

    Mark as a custom (single-booking) option, hidden from public queries.

    Example:
    false
  • earlyBirdAdvanceDaysintegernullable

    Early-bird threshold in days; set together with earlyBirdDiscount or not at all.

    Example:
    30
  • earlyBirdDiscountstringnullable

    Early-bird discount percentage, decimal string.

    Example:
    15.00
  • variantsobject[]

    Variants to reconcile. When omitted on create, a single default (unpriced) variant is created automatically.

    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[]

    Add-ons to reconcile.

    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[]

    Extra booking fields to reconcile.

    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[]

    Scheduled discounts to reconcile.

    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[]

    Resource groups to reconcile. resources is a list of resource UUID strings (objects are rejected).

    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.

Example: Deactivate an option
Deactivate an optionjson
{
  "status": "INACTIVE"
}

Responses

200object

Updated option (full read shape).

  • 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

400

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

401

Missing or invalid X-API-Key header.

403

The API key is valid but not allowed to perform this action on this resource.

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