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
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"
{
"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
currency and returns min_price and variation_ids per date.
Slots for a specific date
GET /api/v1/resellers/activities/{id}/variations/{varId}/availability
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¤cy=USD&guests=2" \
-H "x-api-token: $RESELLER_TOKEN"
{
"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": []
}
]
}
}
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 |
