Skip to main content
Seyaha is an activities marketplace for Saudi Arabia and the wider region. We aggregate activity listings from partners, distribute them through affiliates, and let resellers embed the full booking flow into their own products. There are three distinct API surfaces — pick the one that matches your integration type:

Partner Integration

You supply activities. Connect your OCTO-compatible catalog so Seyaha can sync your products, manage availability, and handle bookings on your behalf.

Reseller API

You sell activities. Browse the full catalog, check availability, and create bookings for your customers using a static API token.

Affiliate API

You refer bookings. List activities, create bookings, and process payments (Moyasar or Stripe) on behalf of authenticated end users via JWT.

​
Base URL

All APIs are served under the same domain: 
https://api.seyaha.net/api/v1
API surfacePath prefix
Partner Integration/partner-integrations
Reseller/resellers
Affiliate/affiliates

​
Response envelope

Every response is wrapped in a consistent envelope: 
{
  "success": 1,
  "data": { ... },
  "pagination": { ... }
}
On error, success is 0 and the envelope includes error and message: 
{
  "success": 0,
  "error": ["field: reason"],
  "message": "Validation Error",
  "code": 400
}
See Errors for the full list of status codes and error shapes.

​
Authentication at a glance

APIMechanism
Partner IntegrationAuthorization: Bearer <JWT>
Resellerx-api-token: <token> header
AffiliateAuthorization: Bearer <JWT>
Webhooks (inbound)x-webhook-secret: <secret> header
Full details in Authentication.