List available dates for an experience
GET/v2/experiences/{experienceId}/availability/dates
Requires your API key in the X-API-Key header.
Returns the dates in [from, until] on which the experience has at least one bookable slot on at least one option for the requested party — a flat, sorted date list intended to paint a booking calendar. There is no per-option breakdown here; drill into a specific date with the slots endpoint.
Visibility
The experience must be visible to the caller: their own experiences, experiences explicitly shared with them, or public active ones. Otherwise this returns 404 — indistinguishable from a non-existent id.
Participants
participants is a comma-separated typeId:count list; every type id must be an active participant type of this experience (400 otherwise). When omitted, availability is participant-agnostic — evaluated for a single participant — and the exact party is re-validated at booking time. Participant types marked capacity-exempt (e.g. infants) do not consume capacity.
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/availability/dates?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
Query parameters
fromstring (date)requiredRange start date (inclusive),
YYYY-MM-DD. Must not be afteruntil.- Example:
2026-07-01
untilstring (date)requiredRange end date (inclusive),
YYYY-MM-DD.- Example:
2026-07-31
participantsstringRequested party as comma-separated
participantTypeId:countpairs (counts must be positive; all type ids must be active types of this experience). When omitted, availability is evaluated for a single participant with no type filtering; the real party is validated at booking time.- Example:
a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44:2,b8d64e12-7a0d-4e2d-8d41-2d2ab2b6ce55:1
optionIdstring (uuid)Narrow the availability check to a single option. Must be a valid UUID (400 otherwise). The snake_case alias
option_idis accepted during migration.- Example:
3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
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
Responses
200object
Sorted list of available dates.
experienceIdstring (uuid)The experience id from the URL.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
fromstring (date)Echo of the requested range start.
- Example:
2026-07-01
untilstring (date)Echo of the requested range end.
- Example:
2026-07-31
availableDatesstring (date)[]Sorted dates on which at least one option has at least one bookable slot for the requested party. Empty when nothing is bookable in the range.
{
"experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
"from": "2026-07-01",
"until": "2026-07-31",
"availableDates": [
"2026-07-14",
"2026-07-15",
"2026-07-18"
]
}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."
}
]
}