# Seyaha

## Docs

- [Create Booking](https://docs.seyaha.net/api-reference/affiliate/create-booking.md): Creates a booking for an activity variation. Returns a booking with status `Booking Attempt`. Proceed to `/create-payment` to confirm and pay.
- [Create Payment](https://docs.seyaha.net/api-reference/affiliate/create-payment.md): Initiates a payment for an existing booking. Supports Moyasar (card-direct) and Stripe (redirect).
- [Get Activity](https://docs.seyaha.net/api-reference/affiliate/get-activity.md): Returns a single activity with full variation and availability detail.
- [List Activities](https://docs.seyaha.net/api-reference/affiliate/list-activities.md): Returns a paginated list of active activities with pricing in the requested currency. Only activities with at least one valid variation are included.
- [Admin — Create Integration](https://docs.seyaha.net/api-reference/partner/admin-create-integration.md): Creates an integration on behalf of any partner. Requires admin role.
- [Admin — List Integrations](https://docs.seyaha.net/api-reference/partner/admin-list-integrations.md): Returns a paginated list of all partner integrations. Requires admin role.
- [Admin — Trigger Sync](https://docs.seyaha.net/api-reference/partner/admin-trigger-sync.md): Manually triggers a full catalog sync for the given integration. Requires admin role.
- [Approve Integration](https://docs.seyaha.net/api-reference/partner/approve-integration.md): Sets `isApproved` on an integration. Requires admin role.
- [Create Integration](https://docs.seyaha.net/api-reference/partner/create-integration.md): Creates a new OCTO integration for the authenticated partner. Each partner may have at most one integration. A `webhook_secret` is generated automatically and returned — store it securely to authenticate inbound webhook calls. The integration starts with `isApproved: false` and must be approved by a…
- [Delete My Integration](https://docs.seyaha.net/api-reference/partner/delete-my-integration.md): Permanently removes the authenticated partner's integration and all associated sync data. This action cannot be undone. Activities imported via this integration will no longer sync.
- [Get Health Status](https://docs.seyaha.net/api-reference/partner/get-health.md): Returns the current health status of the integration and when it was last probed. Partners can only query their own integration; admins can query any.
- [Get My Integration](https://docs.seyaha.net/api-reference/partner/get-my-integration.md): Returns the integration belonging to the authenticated partner.
- [Get Sync Log](https://docs.seyaha.net/api-reference/partner/get-sync-log.md): Returns the latest sync state for the integration: status, last sync timestamp, hash, and any error message. Partners can only query their own integration; admins can query any.
- [Test Connection](https://docs.seyaha.net/api-reference/partner/test-connection.md): Probes `GET {base_url}/products?limit=1` with the partner's configured credentials. Returns `ok: true` on a successful response or `ok: false` with a diagnostic message on failure. Does not modify any state.
- [Update My Integration](https://docs.seyaha.net/api-reference/partner/update-my-integration.md): Updates mutable fields on the authenticated partner's integration (`base_url`, `auth_type`, `auth_key`, `handles_ticket_delivery`).
- [Webhook — Availability Notify](https://docs.seyaha.net/api-reference/partner/webhook-availability-notify.md): Inbound webhook for real-time availability updates in the OCTO `AvailabilityNotify` format. Send this when a single availability slot changes (status, capacity, vacancies) to avoid triggering a full sync. Requires `x-webhook-secret` header.
- [Webhook — Trigger Sync](https://docs.seyaha.net/api-reference/partner/webhook-trigger-sync.md): Inbound webhook that triggers a catalog sync for the given integration. Authenticate by sending the integration's `webhook_secret` in the `x-webhook-secret` header. Call this endpoint from your platform when your catalog changes to push updates to Seyaha immediately rather than waiting for the next…
- [Availability by Date](https://docs.seyaha.net/api-reference/reseller/availability-by-date.md): Returns all bookable slots for the given variation on `date`, with prices converted to the requested `currency` (default SAR). `date` must be `YYYY-MM-DD`. When `guests` is set, only slots that can accommodate that many guests are returned.
- [Availability Calendar (All Variations)](https://docs.seyaha.net/api-reference/reseller/availability-calendar-all.md): Returns a month calendar view for all variations of an activity. Only dates with at least one bookable slot are returned. Defaults to the current year and month when `year` and `month` are omitted.
- [Availability Calendar (Variation)](https://docs.seyaha.net/api-reference/reseller/availability-calendar-variation.md): Returns a lightweight month view: which dates have bookable slots and an aggregated status per date, without returning individual slot records. Defaults to the current year and month when `year` and `month` are omitted.
- [Cancel Booking](https://docs.seyaha.net/api-reference/reseller/cancel-booking.md): Cancels a paid booking and processes refund according to cancellation policy. The booking must have status "Paid by Customer" to be eligible for cancellation.
- [Create Booking](https://docs.seyaha.net/api-reference/reseller/create-booking.md): Creates a new booking for an activity
- [Get Activity](https://docs.seyaha.net/api-reference/reseller/get-activity.md): Retrieves a specific activity by ID. The response returns the activity in a one-element `data` array. Variations do not include the `slots` array; use the availability endpoints for slot-level data.
- [Get User Bookings](https://docs.seyaha.net/api-reference/reseller/get-user-bookings.md): Retrieves all bookings for a specific user by user ID
- [List Activities](https://docs.seyaha.net/api-reference/reseller/list-activities.md): Retrieves all activities available to the reseller. Bookable slots are not included on each variation; use the availability calendar and availability-by-date endpoints to load slots for a variation.
- [Payment Success](https://docs.seyaha.net/api-reference/reseller/payment-success.md): Updates a booking status after successful payment
- [Activities](https://docs.seyaha.net/pages/affiliate/activities.md): Browse and search the activity catalog as an affiliate.
- [Bookings & Payments](https://docs.seyaha.net/pages/affiliate/bookings.md): Create bookings and process payments via Moyasar or Stripe.
- [Affiliate Quickstart](https://docs.seyaha.net/pages/affiliate/quickstart.md): List activities, create a booking, and process payment in four steps.
- [Authentication](https://docs.seyaha.net/pages/authentication.md): How to authenticate with each Seyaha API surface.
- [Errors](https://docs.seyaha.net/pages/errors.md): Standard error shape and HTTP status codes across all Seyaha APIs.
- [Introduction](https://docs.seyaha.net/pages/introduction.md): Connect your platform to the Seyaha activities marketplace.
- [Health Monitoring](https://docs.seyaha.net/pages/partner/health.md): Integration health states and how Seyaha responds to connectivity issues.
- [OCTO Protocol](https://docs.seyaha.net/pages/partner/octo-protocol.md): How Seyaha implements the OCTO standard to sync your catalog.
- [Partner Quickstart](https://docs.seyaha.net/pages/partner/quickstart.md): Connect your activity catalog to Seyaha in four steps.
- [Catalog Sync](https://docs.seyaha.net/pages/partner/sync.md): How Seyaha keeps your catalog in sync and how to push updates proactively.
- [Webhooks](https://docs.seyaha.net/pages/partner/webhooks.md): Inbound webhook endpoints for pushing sync and availability events to Seyaha.
- [Activities](https://docs.seyaha.net/pages/reseller/activities.md): Browse and search the Seyaha activity catalog as a reseller.
- [Availability](https://docs.seyaha.net/pages/reseller/availability.md): Check bookable slots using the calendar view or date-specific endpoint.
- [Bookings](https://docs.seyaha.net/pages/reseller/bookings.md): Create, confirm, and cancel bookings via the Reseller API.
- [Reseller Quickstart](https://docs.seyaha.net/pages/reseller/quickstart.md): Get your first booking in four steps using the Reseller API.

## OpenAPI Specs

- [reseller](https://docs.seyaha.net/api-specs/reseller.yaml)
- [partner-integrations](https://docs.seyaha.net/api-specs/partner-integrations.yaml)
- [affiliate](https://docs.seyaha.net/api-specs/affiliate.yaml)