Skip to main content

Experience Availability API

The Availability API lets you check real-time availability for experiences before creating bookings.

Why Check Availability?​

Before adding experiences to a booking, verify there are spots available:

  • Check remaining capacity for schedule slots
  • Prevent overbooking
  • Display accurate availability on your website

API Endpoints​

MethodEndpointDescriptionScope Required
GET/v1/availability/experiencesCheck experience availabilityexperiences:read

Experience Availability​

Experience availability is based on:

  • Maximum capacity per schedule slot
  • Current bookings for that slot
  • Available spots = Max capacity - Booked participants

Schedule Slots​

Experiences run on defined schedules with specific:

  • Start times (e.g., 9:00 AM, 2:00 PM)
  • Duration (e.g., 2 hours)
  • Days of week (e.g., weekends only)
  • Capacity (e.g., max 10 participants)

Common Use Cases​

Check Available Spots​

Before booking a tour, check if there's room:

curl "https://app.equipdash.com/api/v1/availability/experiences?experience_id=5&date=2026-02-15" \
  -H "Authorization: Bearer YOUR_API_KEY"

Check Specific Schedule Slot​

Check a specific time slot:

curl "https://app.equipdash.com/api/v1/availability/experiences?experience_id=5&schedule_id=123&participants=4" \
  -H "Authorization: Bearer YOUR_API_KEY"

Display Calendar Availability​

Show available dates on your booking calendar:

curl "https://app.equipdash.com/api/v1/availability/experiences?experience_id=5&start_date=2026-02-01&end_date=2026-02-28" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example​

{
  "data": {
    "experience_id": 5,
    "available_slots": [
      {
        "schedule_id": 123,
        "date": "2026-02-15",
        "start_time": "09:00",
        "end_time": "11:00",
        "max_capacity": 10,
        "booked": 6,
        "available": 4
      },
      {
        "schedule_id": 124,
        "date": "2026-02-15",
        "start_time": "14:00",
        "end_time": "16:00",
        "max_capacity": 10,
        "booked": 2,
        "available": 8
      }
    ]
  }
}