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.

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

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • optionIdstring (uuid)required

    UUID of the option (must belong to the experience in the path).

    Example:
    3d3f9c2a-1b2c-4d5e-8f90-a1b2c3d4e5f6

Query parameters

  • fromstring (date)required

    Range start date (inclusive), local to the experience, YYYY-MM-DD.

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

    Range 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
    • startTimestringnullable

      Slot start time (HH:MM:SS local). null for DATE_ONLY options.

      Example:
      09:00:00
    • localTimestring

      Combined local start as an ISO string — YYYY-MM-DDTHH:MM:SS, or just YYYY-MM-DD when the slot has no start time.

      Example:
      2026-07-14T09:00:00
    • isBookableboolean

      Whether the slot accepts new bookings. False when the organizer closed sales or slot regeneration orphaned it while it still had bookings.

      Example:
      true
    • externalCapacityintegernullable

      Capacity last reported by the external provider. Authoritative only on genuinely external options; a stale value on native Turneo options is ignored for status computation.

    • capacityOverrideintegernullable

      Organizer-set per-slot capacity cap. null means the option's slotCapacity applies.

      Example:
      8
    • bookingsQuantityinteger

      Capacity-relevant participants currently booked on the slot (live bookings only, including guest basket holds; capacity-exempt types such as infants excluded).

      Example:
      2
    • onHoldQuantityinteger

      Subset of bookingsQuantity sitting 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) availableQuantity is the provider's own count and is not reduced by local bookings, so the three quantities do not reconcile there.

      Example:
      1
    • availableQuantityintegernullable

      Remaining bookable capacity (effective capacity minus bookingsQuantity). null when the option has no capacity source (e.g. purely resource-driven).

      Example:
      6
    • availabilityStatusstring

      Computed 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
    • discountobjectnullable

      Discount a booking made right now would receive, or null.

      Child fields
      • percentagenumber

        Discount percentage.

        Example:
        10
      • typestring

        Discount source — the option's early-bird rule or a scheduled availability discount.

        Allowed values:
        EARLY_BIRDAVAILABILITY
        Example:
        AVAILABILITY
Response 200json
{
  "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[].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."
    }
  ]
}