Get Schedule

Get a single schedule slot by ID.

Endpoint

GET /v1/experiences/{id}/schedules/{scheduleId}

Authentication

Requires an API key with the experiences:read scope.

Path Parameters

Parameter	Type	Description
id	integer	Experience ID
scheduleId	integer	Schedule ID

Example Request

curl -X GET "https://app.equipdash.com/api/v1/experiences/1/schedules/3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Success (200 OK)

{
  "data": {
    "id": 3,
    "date": "2026-02-20",
    "start_time": "10:00",
    "capacity": 12,
    "booked_slots": 5,
    "held_slots": 0,
    "available_slots": 7,
    "available": true,
    "guides": [
      {
        "id": 1,
        "name": "John Smith"
      },
      {
        "id": 2,
        "name": "Jane Doe"
      }
    ],
    "timezone": "America/New_York",
    "start_datetime_utc": "2026-02-20T15:00:00+00:00",
    "end_datetime_utc": "2026-02-20T17:00:00+00:00",
    "multi_day": false,
    "days_nights": null,
    "days_nights_short": null,
    "created_at": "2026-02-01T10:00:00+00:00",
    "updated_at": "2026-02-01T10:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T10:00:00+00:00"
  }
}

Response Fields

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
groups_capacity	integer|null	Groups-per-slot override for this departure (null = inherit the experience default). Shared group-priced experiences only
effective_groups_capacity	integer|null	The cap actually in force — the override above, else the experience's default_groups_capacity. null = unlimited
available_groups	integer|null	Groups still bookable under that cap. null when no cap applies
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 or schedule not found