Show our activities, yachts, events and travel extras on your own website or booking system, at your agent prices, and book them straight from your agency wallet. Ask your account manager for a sandbox key.
Basics
Base URL: https://umairaghaditourism.com/api/v1 β HTTPS, JSON in and out.
Auth: Authorization: Bearer bsk_β¦ on every request (or X-Api-Key).
Sandbox keys (bsk_test_β¦) run every check and return a priced quote, but create no booking and charge nothing. Live keys (bsk_live_β¦) book for real.
Prices are in AED and already include your agent discount. Bookings are paid from your wallet / credit.
Errors: {"error": {"code", "message"}}; validation errors are 422 with errors.field messages. Limits per key (default 60 requests / minute) β 429 with Retry-After.
Endpoints
Method
Path
What it does
GET
/account
Your wallet balance, credit and discount
GET
/products?type=tour|yacht|event|extra&city=dubai
Product list with your "from" price (paginated: page, per_page β€ 100)
GET
/products/{product}
Options, time slots, transfers, extras, guest rules, cancellation policy
reference is your own order number β send the same one again and you get the same booking back (no double booking).
units = hours for private charters, quantity for per-item products (SIM, eSIMβ¦).
The response (201) has booking_no, status, total, every item and a voucher_url (signed PDF link, valid 180 days) you can give your customer. voucher_url is null until the voucher can be issued.
Not enough wallet balance or credit β 422 and nothing is booked.
Hotels, holidays, Umrah, cruises, visas and transfers
Method
Path
What it does
GET
/catalog/{module}
module = hotels | holidays | umrah | cruises | visas | transfers | combos β live products with your "from" price
GET
/catalog/{module}/{product}
Public details of one product
POST
/modules/{module}/bookings
Book it: send the same fields as the website booking form (plus "product" for hotels, holidays, cruises and visas; visa documents as multipart files)
GET
/modules/{module}/bookings/{booking_no}
Status, payment, request state and a link to the booking page for your guest
POST
/modules/{module}/bookings/{booking_no}/pay
Pay a booking that is waiting for payment from your wallet (hotels after the team holds the rooms, requests once confirmed)
These bookings follow exactly the same rules as an agent booking on the website: hotels are request-first (the team confirms, then you pay), On Request products are not charged until confirmed.
Combos: book all the products of a combo in one POST /bookings and the combo saving is applied automatically.
Transfers: send dropoff_address (hotel name or address), plus any extra field our booking form marks as required β a missing one comes back as a 422 error naming the field.
Sandbox keys can browse these products but not book them.
On Request products
Every product shows booking_type: instant or on_request. If any item in a booking is on_request, the whole booking is a request:
You book as usual. Nothing is charged. The booking has request_state: "requested".
Our team checks availability. You get a booking.updated webhook (and an email) with request_state: "available" or "declined".
When it is available, call POST /bookings/{booking_no}/pay. The amount is taken from your wallet and the voucher becomes available.
Webhooks
Give us an https URL for your live key and we POST booking.updated whenever one of your bookings changes (confirmed, cancelled, refunded):
Check it came from us: X-BS-Signature = HMAC-SHA256 of the raw body with your webhook secret. Reply 2xx within 5 seconds.
Good to know
Always check availability right before booking β seats and prices are checked again when you book.
A section that is switched off or marked Coming Soon on the website (Activities, Yachts, Events, Travel Extras) is not listed and cannot be booked through the API either.
Keep your key on your server only. If it leaks, ask us to revoke it and issue a new one. We can also lock a key to your server's IP addresses.
The version is in the URL (/v1); changes that could break your integration will come as /v2.