Introduction - Seyaha

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://backend.seyaha.net/api/v1

API surface	Path 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

API	Mechanism
Partner Integration	`Authorization: Bearer <JWT>`
Reseller	`x-api-token: <token>` header
Affiliate	`Authorization: Bearer <JWT>`
Webhooks (inbound)	`x-webhook-secret: <secret>` header

Full details in Authentication.

Partner Integration

Reseller API

Affiliate API

​Base URL

​Response envelope

​Authentication at a glance

Base URL

Response envelope

Authentication at a glance