Availability

Seyaha provides two availability endpoints for resellers — use the calendar for date picking UIs and the date-specific endpoint to load actual bookable slots.

Calendar view (month)

GET /api/v1/resellers/activities/{id}/variations/{varId}/availability/calendar

Returns a lightweight month view showing which dates have bookable slots. Does not return individual slot records — use this to build a date picker and only load slots for the date the user selects.

Defaults to the current month when year and month are omitted.

Parameters

Parameter	Type	Description
`year`	integer	Calendar year (e.g. `2026`)
`month`	integer	Month 1–12
`guests`	integer	When set, only dates with slots that fit this many guests are included

curl "https://api.seyaha.net/api/v1/resellers/activities/$ACTIVITY_ID/variations/$VAR_ID/availability/calendar?year=2026&month=7&guests=2" \
  -H "x-api-token: $RESELLER_TOKEN"

const params = new URLSearchParams({ year: '2026', month: '7', guests: '2' });
const res = await fetch(
  `https://api.seyaha.net/api/v1/resellers/activities/${activityId}/variations/${varId}/availability/calendar?${params}`,
  { headers: { 'x-api-token': process.env.RESELLER_TOKEN } }
);
const { data } = await res.json();
// data.dates → array of { date, status, slot_count }

Response:

{
  "success": 1,
  "data": {
    "year": 2026,
    "month": 7,
    "dates": [
      { "date": "2026-07-10", "status": "AVAILABLE", "slot_count": 3 },
      { "date": "2026-07-15", "status": "LIMITED", "slot_count": 1 },
      { "date": "2026-07-20", "status": "SOLD_OUT", "slot_count": 0 }
    ]
  }
}

Calendar across all variations

To get a unified calendar for an activity (without specifying a variation):

GET /api/v1/resellers/activities/{id}/availability/calendar

This endpoint also accepts currency and returns min_price and variation_ids per date.

Slots for a specific date

GET /api/v1/resellers/activities/{id}/variations/{varId}/availability

Returns all bookable time slots for the variation on a given date. Call this after the user selects a date from the calendar.

Parameters

Parameter	Required	Description
`date`	Yes	`YYYY-MM-DD` format
`currency`	No	Defaults to SAR
`guests`	No	Filter to slots with at least this many vacancies

curl "https://api.seyaha.net/api/v1/resellers/activities/$ACTIVITY_ID/variations/$VAR_ID/availability?date=2026-07-15&currency=USD&guests=2" \
  -H "x-api-token: $RESELLER_TOKEN"

const params = new URLSearchParams({ date: '2026-07-15', currency: 'USD', guests: '2' });
const res = await fetch(
  `https://api.seyaha.net/api/v1/resellers/activities/${activityId}/variations/${varId}/availability?${params}`,
  { headers: { 'x-api-token': process.env.RESELLER_TOKEN } }
);
const { data } = await res.json();
// data.slots → array of bookable slots

Response:

{
  "success": 1,
  "data": {
    "date": "2026-07-15",
    "variation_id": "6751ad2d7533f379c9a1711b",
    "slots": [
      {
        "slot_id": "slot_001",
        "time": "10:00",
        "status": "AVAILABLE",
        "vacancies": 14,
        "capacity": 20,
        "max_booking": 10,
        "pricing": [
          { "type": "ADULT", "label": "Adult", "price": 120 },
          { "type": "CHILD", "label": "Child", "price": 75 }
        ]
      },
      {
        "slot_id": "slot_002",
        "time": "14:00",
        "status": "LIMITED",
        "vacancies": 2,
        "capacity": 20,
        "max_booking": 10,
        "group_price": 450,
        "pricing": []
      }
    ]
  }
}

When group_price is non-null, the slot uses flat group pricing. Show group_price rather than per-person pricing units in your UI.

Slot status reference

Status	Meaning
`AVAILABLE`	Bookable, plenty of capacity
`FREESALE`	Unlimited capacity — always bookable
`LIMITED`	Bookable but low vacancies
`SOLD_OUT`	No vacancies left
`CLOSED`	Not available for booking

Dashboard Guide

API Guide

API Reference

Calendar view (month)

Parameters

Calendar across all variations

Slots for a specific date

Parameters

Slot status reference

​Calendar view (month)

​Parameters

​Calendar across all variations

​Slots for a specific date

​Parameters

​Slot status reference

Calendar view (month)

Parameters

Calendar across all variations

Slots for a specific date

Parameters

Slot status reference