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.
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)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
optionIdstring (uuid)requiredUUID of the option (must belong to the experience in the path).
- Example:
3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
Query parameters
restrictedbooleanVariant 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 thantrueis treated asfalse.- Example:
false
languagestringTwo-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-onlyThe parent experience id (always the experience in the URL).
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
statusstringLifecycle 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 stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.codestringnullableFree-form organizer reference code.
- Example:
KAYAK-AM
scoreintegerSort weight (ascending). Auto-assigned to the bottom on create when omitted; deactivated/deleted options are pushed to the bottom automatically.
- Example:
100
externalIdstringnullableread-onlyExternal provider identifier when the option is synced from Bokun/Regiondo/Kompas. Externally-synced options cannot be mutated through this API.
notemap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.instantUntilDurationobjectnullableBooking 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
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes 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)nullableFirst sellable date. Required for ACTIVE options.
- Example:
2026-07-01
endDatestring (date)nullableLast sellable date.
nullmeans open-ended.- Example:
2026-09-30
slotTypestringnullableHow 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
flexibleSlotConfigobjectnullableFLEXIBLE schedule config. Required for FLEXIBLE, must be empty otherwise.
fromTimeaftertoTimedescribes an overnight window.Child fields
fromTimestringWindow start,
HH:MMlocal time.- Example:
08:00
toTimestringWindow end,
HH:MMlocal time.- Example:
18:00
intervalstringStep between generated slots,
HH:MM.- Example:
00:30
daysOfWeekinteger[]Weekdays slots are generated for (0=Monday … 6=Sunday). Must be non-empty.
fixedSlotConfigobject[]nullableFIXED schedule config — explicit start times per set of weekdays. Required for FIXED, must be empty otherwise.
Child fields
timestringSlot start time,
HH:MMlocal.- Example:
09:00
daysOfWeekinteger[]Weekdays this start time applies to (0=Monday … 6=Sunday). Must be non-empty.
groupTypestringnullableWhether a booked resource is private to one party or shared. Required when resource groups are configured; must be empty otherwise.
- Allowed values:
PRIVATEPUBLICnull
slotCapacityintegernullableParticipants per slot. Ignored (auto-nulled) when resource groups drive capacity. Individual slots can cap it further via
capacityOverride.- Example:
10
pricingModelstringnullableHow 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
durationobjectnullableFixed 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
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes component.
- Example:
30
durationIncrementobjectnullableDURATION_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
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes component.
- Example:
30
durationPricingUnitstringnullableUI-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
multiDayModestringnullableFor 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
allowPartialDaybooleanFixed-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
custombooleanTrue for one-off options auto-created for a specific custom booking. Custom options are excluded from public catalog queries and availability.
- Example:
false
earlyBirdAdvanceDaysintegernullableDays in advance a booking must be made to earn the early-bird discount. Must be set together with
earlyBirdDiscount.- Example:
30
earlyBirdDiscountstringnullableEarly-bird discount percentage, decimal string. Set together with
earlyBirdAdvanceDays.- Example:
15.00
variantsobject[]Active variants, filtered by the
restrictedquery 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 stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.imagestringnullableURL of an illustrative image for the variant.
- Example:
https://cdn.turneo.com/variants/premium.jpg
maxParticipantsintegernullableMaximum capacity-relevant participants this variant can hold per booking.
nullmeans unlimited.- Example:
8
sortOrderintegerDisplay position among the option's variants (ascending).
- Example:
0
flatPricestringnullableFlat price per booking, decimal string. Only for FLAT_RATE pricing.
- Example:
150.00
groupSizeUnitstringnullableHow 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
minQuantityintegerInclusive lower bound of the band. The first tier must start at 1.
- Example:
1
maxQuantityintegernullableInclusive upper bound of the band.
nullmakes the tier open-ended ("7+"); only the last tier may be open-ended.- Example:
6
pricestringPrice 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
pricestringPrice per participant of this type, decimal string.
- Example:
45.00
restrictedbooleanMarks the variant as exclusive/member-only. Restricted variants are hidden or surfaced by the
restrictedquery 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 stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.sortOrderintegerDisplay position (ascending).
- Example:
0
addonTypestringUI behaviour — a simple yes/no checkbox or a quantity selector.
- Allowed values:
CHECKBOXQUANTITY_SELECTOR- Example:
QUANTITY_SELECTOR
perPersonbooleanWhen true, the add-on price/quantity applies per participant instead of per booking.
- Example:
false
maxQuantityintegernullableMaximum quantity selectable (QUANTITY_SELECTOR).
nullmeans no cap.- Example:
5
pricestringnullablePrice per unit, decimal string.
nullmeans free.- Example:
12.00
nonCommissionablebooleanWhen 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 stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.sortOrderintegerDisplay position (ascending).
- Example:
0
fieldTypestringFree-text question or boolean checkbox.
- Allowed values:
QUESTIONCHECKBOX- Example:
QUESTION
requiredbooleanWhether 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
percentageAmountstringDiscount percentage as a decimal string.
- Example:
10.00
startDatestring (date)nullableFirst slot date the discount applies to.
- Example:
2026-07-01
endDatestring (date)nullableLast slot date the discount applies to.
- Example:
2026-07-31
fromTimestringnullableEarliest slot start time the discount applies to,
HH:MM[:SS]local.- Example:
09:00
untilTimestringnullableLatest slot start time the discount applies to,
HH:MM[:SS]local.- Example:
12:00
daysOfWeekinteger[]nullableWeekdays the discount applies to (0=Monday … 6=Sunday).
resourceGroupsobject[]Active resource groups, with read-only
resourceDetailsexpansion.Child fields
idstring (uuid)Group id. Omit on create; include on update.
- Example:
2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f
namestringnullableOrganizer-facing group label.
- Example:
Kayaks
resourcesstring (uuid)[]IDs of the resources in this group.
resourceDetailsobject[]read-onlyRead-only expansion of the group's resources.
Child fields
idstring (uuid)Resource id.
- Example:
c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f
namestringResource name.
- Example:
Kayak 1
capacityintegernullableMaximum participants the resource can hold (its
maxParticipants).- Example:
2
{
"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-Keyheader.- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}