List Schedules

Get all schedule slots for an experience.

Endpoint

GET /v1/experiences/{id}/schedules

Authentication

Requires an API key with the experiences:read scope.

Path Parameters

Parameter	Type	Description
id	integer	Experience ID

Query Parameters

Parameter	Type	Description
start_date	string	Filter from date (YYYY-MM-DD)
end_date	string	Filter to date (YYYY-MM-DD)
available_only	string	true to show only available slots

Example Request

curl -X GET "https://app.equipdash.com/api/v1/experiences/1/schedules?start_date=2026-02-01&end_date=2026-02-28&available_only=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Success (200 OK)

{
  "data": {
    "experience_id": 1,
    "schedules": [
      {
        "id": 1,
        "date": "2026-02-15",
        "start_time": "09:00",
        "capacity": 10,
        "booked_slots": 3,
        "held_slots": 0,
        "available_slots": 7,
        "available": true,
        "guides": [
          {
            "id": 1,
            "name": "John Smith"
          }
        ],
        "timezone": "America/New_York",
        "start_datetime_utc": "2026-02-15T14:00:00+00:00",
        "end_datetime_utc": "2026-02-15T16:00:00+00:00",
        "multi_day": false,
        "days_nights": null,
        "days_nights_short": null,
        "created_at": "2026-01-15T10:00:00+00:00",
        "updated_at": "2026-01-15T10:00:00+00:00"
      },
      {
        "id": 2,
        "date": "2026-07-13",
        "start_time": "09:00",
        "capacity": 10,
        "booked_slots": 0,
        "held_slots": 0,
        "available_slots": 10,
        "available": true,
        "guides": [],
        "timezone": "America/New_York",
        "start_datetime_utc": "2026-07-13T13:00:00+00:00",
        "end_datetime_utc": "2026-07-15T21:00:00+00:00",
        "multi_day": true,
        "days_nights": "3 Days / 2 Nights",
        "days_nights_short": "3 Days",
        "created_at": "2026-01-15T10:00:00+00:00",
        "updated_at": "2026-01-15T10:00:00+00:00"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T10:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
experience_id	integer	The experience these schedules belong to
schedules	array	Array of schedule objects

Schedule Object

Field	Type	Description
id	integer	Unique schedule identifier
date	string	Date of the schedule (YYYY-MM-DD)
start_time	string	Local start time (HH:MM)
capacity	integer	Maximum participants
booked_slots	integer	Currently booked count
held_slots	integer	Spots customers are holding in their booking-page carts right now, in the same unit as booked_slots. Not booked, and not free to sell until the hold ends
available_slots	integer	Spots that can still be sold, the same number the booking page shows (gear out on rentals, closures and guides count). See the schedule fields
available	boolean	Can accept bookings
booking_option_id	integer | null	The booking option this session runs for. null = it runs for every option
guides	array	Assigned guides
timezone	string	Schedule timezone
start_datetime_utc	string	Authoritative start instant (UTC, ISO 8601)
end_datetime_utc	string | null	Authoritative return instant (UTC, ISO 8601). For a multi-day departure this is on a later day
multi_day	boolean	true when the departure returns on a later calendar day (one booking spanning several days)
days_nights	string | null	Trip length in tour-operator phrasing (days first, nights = days − 1), e.g. "5 Days / 4 Nights". null for single-day departures
days_nights_short	string | null	Compact days-only trip length for tight UI (pills/chips), e.g. "5 Days". null for single-day departures
created_at	string	ISO 8601 datetime
updated_at	string	ISO 8601 datetime

Errors

Status	Code	Description
401	authentication_required	No API key provided
403	insufficient_scope	API key lacks experiences:read scope
404	not_found	Experience not found