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.

Requestbash
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)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f

Query parameters

  • fromstring (date)required

    Range start date (inclusive), YYYY-MM-DD. Must not be after until.

    Example:
    2026-07-01
  • untilstring (date)required

    Range end date (inclusive), YYYY-MM-DD.

    Example:
    2026-07-31
  • participantsstring

    Requested party as comma-separated participantTypeId:count pairs (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_id is accepted during migration.

    Example:
    3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6
  • 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

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.

Response 200json
{
  "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[].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."
    }
  ]
}