Create an option
POST/v2/experiences/{experienceId}/options
Requires your API key in the X-API-Key header.
Creates a new option on the experience. Requires authentication and is restricted to the experience's organizer; other callers get a 403. Returns 400 if the experience's availability is sourced from an external provider (Bokun/Regiondo/Kompas) — externally-synced options can only be managed by the sync.
Options default to status: DRAFT and are placed at the bottom of the sort order unless score is given; if no variants are provided a single default variant is created automatically. Creating with status: ACTIVE requires a complete configuration — startDate, pricingModel, slotType, slot config and variant pricing matching that model, and any resource-group requirements — a DRAFT option can be saved half-configured, an ACTIVE one cannot (400 otherwise). Activating an option immediately generates its availability slots and may trigger auto-translation of the experience content.
curl -X POST "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options" \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"name": {
"en": "Shared boat tour"
}
}'Path parameters
experienceIdstring (uuid)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
Request bodyapplication/json, required
statusstringLifecycle 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 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; auto-assigned to the bottom when omitted on create.
- Example:
300
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 (see read shape).
Child fields
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes 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, andcapacityExempt.disabledParticipantTypesmay reference UUIDs created in the same request and represents the final disabled state for this option.Child fields
idstring (uuid)requirednamemap 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.descriptionmap 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.minAgeintegernullablemaxAgeintegernullablecapacityExemptbooleansortOrderinteger
startDatestring (date)nullableFirst sellable date. Required for ACTIVE options. Changing it regenerates slots.
- Example:
2026-07-01
endDatestring (date)nullableLast sellable date; must not be before
startDate. Changing it regenerates slots.- Example:
2026-09-30
slotTypestringnullableSlot generation mode. Changing it regenerates slots.
- Allowed values:
FLEXIBLEFIXEDDATE_ONLYnull- Example:
FIXED
flexibleSlotConfigobjectnullableFLEXIBLE schedule config (see read shape). Changing it regenerates slots.
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 (0=Monday … 6=Sunday), non-empty.
fixedSlotConfigobject[]nullableFIXED schedule config (see read shape). Changing it regenerates slots.
Child fields
timestringSlot start time,
HH:MMlocal.- Example:
09:00
daysOfWeekinteger[]Weekdays (0=Monday … 6=Sunday), non-empty.
groupTypestringnullableRequired when resource groups are configured; empty otherwise.
- Allowed values:
PRIVATEPUBLICnull
slotCapacityintegernullableParticipants per slot; auto-nulled when resource groups are configured.
- Example:
10
pricingModelstringnullablePricing 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
durationobjectnullableFixed booking duration (non-DURATION_BASED models).
Child fields
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes component.
- Example:
30
durationIncrementobjectnullableBookable increment (DURATION_BASED only).
Child fields
daysintegerWhole days component.
- Example:
0
hoursintegerHours component.
- Example:
2
minutesintegerMinutes component.
- Example:
30
durationPricingUnitstringnullableUI-only pricing-unit hint for DURATION_BASED options.
- Allowed values:
PER_PERSONPER_RESOURCEnull
multiDayModestringnullableRental-window end semantics for multi-day options.
- Allowed values:
ROLLING_24HCALENDAR_DAYnull- Example:
CALENDAR_DAY
allowPartialDaybooleanAccept 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
custombooleanMark as a custom (single-booking) option, hidden from public queries.
- Example:
false
earlyBirdAdvanceDaysintegernullableEarly-bird threshold in days; set together with
earlyBirdDiscountor not at all.- Example:
30
earlyBirdDiscountstringnullableEarly-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 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[]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 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[]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 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[]Scheduled discounts to reconcile.
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[]Resource groups to reconcile.
resourcesis 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
namestringnullableOrganizer-facing group label.
- Example:
Kayaks
resourcesstring (uuid)[]IDs of the resources in this group.
Example: Minimal draft option
{
"name": {
"en": "Shared boat tour"
}
}Example: Active per-person option with a fixed schedule
{
"status": "ACTIVE",
"name": {
"en": "Morning kayak"
},
"startDate": "2026-07-01",
"endDate": "2026-09-30",
"slotType": "FIXED",
"fixedSlotConfig": [
{
"time": "09:00",
"daysOfWeek": [
0,
1,
2,
3,
4
]
}
],
"pricingModel": "PER_PERSON",
"slotCapacity": 10,
"duration": {
"days": 0,
"hours": 2,
"minutes": 0
},
"variants": [
{
"name": {
"en": "Standard"
},
"participantPrices": [
{
"participantTypeId": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
"price": "45.00"
}
]
}
]
}Responses
201object
Option created. Returns the full read shape.
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
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 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
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."
}
]
}