List calendar slots of an option
GET/v2/experiences/{experienceId}/options/{optionId}/slots
Requires your API key in the X-API-Key header.
Full calendar view of an option's availability slots in a date range, for managing your own inventory. Unlike the guest-facing availability endpoints, this returns every operational slot — selling, sold-out, blocked, sales-closed and soft-deleted ones — each with a computed availabilityStatus, live booked quantity and remaining capacity.
Requires authentication; only the experience's organizer, or a partner explicitly granted access to it, may read this calendar. Everyone else gets a 403.
from and until are required YYYY-MM-DD dates (inclusive, matched on the slot's local start date) and from must not be after until.
Status semantics
SELLING — bookable with remaining capacity. SOLD_OUT — no remaining capacity. BLOCKED — an active option block overlaps the slot. CLOSED — sales are stopped on this slot (isBookable: false); the slot is still live and its bookings are untouched. CANCELLED — the slot is soft-deleted and every booking on it has been cancelled.
SOLD_OUT outranks CLOSED: a slot at capacity reports SOLD_OUT whether or not its sales are stopped, so read isBookable rather than inferring it from the status.
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/options/3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6/slots?from=2026-07-01&until=2026-07-31" \
-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
fromstring (date)requiredRange start date (inclusive), local to the experience,
YYYY-MM-DD.- Example:
2026-07-01
untilstring (date)requiredRange end date (inclusive), local to the experience,
YYYY-MM-DD.- Example:
2026-07-31
Responses
200object
All operational slots in the range, ordered by date and time.
experienceIdstring (uuid)The experience id from the URL.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
optionIdstring (uuid)The option id from the URL.
- Example:
3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
fromstring (date)Echo of the requested range start.
- Example:
2026-07-01
untilstring (date)Echo of the requested range end.
- Example:
2026-07-31
slotsobject[]All operational slots in the range, ordered by date then time.
Child fields
idstring (uuid)Slot id.
- Example:
6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d
startDatestring (date)Slot date, local to the experience.
- Example:
2026-07-14
startTimestringnullableSlot start time (
HH:MM:SSlocal).nullfor DATE_ONLY options.- Example:
09:00:00
localTimestringCombined local start as an ISO string —
YYYY-MM-DDTHH:MM:SS, or justYYYY-MM-DDwhen the slot has no start time.- Example:
2026-07-14T09:00:00
isBookablebooleanWhether the slot accepts new bookings. False when the organizer closed sales or slot regeneration orphaned it while it still had bookings.
- Example:
true
externalCapacityintegernullableCapacity last reported by the external provider. Authoritative only on genuinely external options; a stale value on native Turneo options is ignored for status computation.
capacityOverrideintegernullableOrganizer-set per-slot capacity cap.
nullmeans the option'sslotCapacityapplies.- Example:
8
bookingsQuantityintegerCapacity-relevant participants currently booked on the slot (live bookings only, including guest basket holds; capacity-exempt types such as infants excluded).
- Example:
2
onHoldQuantityintegerSubset of
bookingsQuantitysitting in guest baskets (ON_HOLD). Still consumes capacity until the guest pays or the hold lapses. Can lag by up to the hold-expiry sweep interval: a lapsed hold still reads as held until the expiry task runs. On external-provider slots (Bokun/Regiondo/Rezdy)availableQuantityis the provider's own count and is not reduced by local bookings, so the three quantities do not reconcile there.- Example:
1
availableQuantityintegernullableRemaining bookable capacity (effective capacity minus
bookingsQuantity).nullwhen the option has no capacity source (e.g. purely resource-driven).- Example:
6
availabilityStatusstringComputed operational status: SELLING (bookable, capacity left), SOLD_OUT (no capacity left), BLOCKED (overlapped by an option block), CLOSED (sales stopped on this slot,
isBookable: false, bookings untouched), CANCELLED (soft-deleted, its bookings cancelled).- Allowed values:
SELLINGSOLD_OUTBLOCKEDCLOSEDCANCELLED- Example:
SELLING
discountobjectnullableDiscount a booking made right now would receive, or null.
Child fields
percentagenumberDiscount percentage.
- Example:
10
typestringDiscount source — the option's early-bird rule or a scheduled availability discount.
- Allowed values:
EARLY_BIRDAVAILABILITY- Example:
AVAILABILITY
{
"experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
"optionId": "3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6",
"from": "2026-07-01",
"until": "2026-07-31",
"slots": [
{
"id": "6a5b4c3d-2e1f-4a9b-8c7d-6e5f4a3b2c1d",
"startDate": "2026-07-14",
"startTime": "09:00:00",
"localTime": "2026-07-14T09:00:00",
"isBookable": true,
"externalCapacity": null,
"capacityOverride": 8,
"bookingsQuantity": 2,
"onHoldQuantity": 1,
"availableQuantity": 6,
"availabilityStatus": "SELLING",
"discount": {
"percentage": 10,
"type": "AVAILABILITY"
}
}
]
}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."
}
]
}