Listings and photos
Listings in five categories, unit inventory, photos and a description in your language; we translate it into four languages.
POST /v1/listings
Developers
Connect your PMS or CRM to Bounty
Bookings from Bounty guests arrive in your system on their own, and your busy dates and prices flow back to us. No manual calendar, no double bookings.
Dates are in the listing's time zone; money is in minor currency units.
Three steps to your first bookings
- 01 A partner account Sign-up is open. Fill in the business profile; a moderator reviews it and the cabinet opens.
- 02 An API key in the cabinet Company → Developers. Choose the sections and access level, as for a staff member. The key works without signing in or a captcha.
- 03 Your developer connects it The documentation is public and every endpoint has an example. It's easiest to test the connection on a listing that isn't published yet.
What the partner API can do
Everything in the partner cabinet except staff, company documents and payout details.
Calendar and closures
Booked in your system? Close the dates or a unit with us in one request, up to 50 ranges at once.
PUT /v1/listings/{id}/availability
Prices and rules
Daily prices, minimum nights, rates, extras and price rules: exactly what goes on the guest's bill.
PUT /v1/listings/{id}/pricing
Bookings and check-in
New bookings, confirming and declining, guests, QR check-in, check-out and no-shows.
POST /v1/bookings/{id}/confirm
Guest messages
Read and reply from your system; we translate into the guest's language.
POST /v1/dialogs/{id}/messages
Reviews and finance
Review replies, deductions, payouts and period reports.
GET /v1/finance/payouts
Webhooks
Hear about a new booking or guest message within seconds, without polling.
booking.createdbooking.confirmedbooking.cancelledmessage.new
More ways to connect
No developer? Start with iCal
A calendar link for each unit goes to Airbnb, Booking.com or your PMS, and their calendars come to us. Taken dates sync by themselves; setup takes ten minutes in the dashboard.
GET /v1/ical/{secret}.ics
Hundreds of units in one job
Create and update listings with units and photos by link, close dates and change prices across many listings at once: the job runs in the background and the report lists what failed and why.
POST /v1/bulk/listings
For integrators
Building a PMS or channel manager module for many businesses? We will register your app on request: one key, and each business grants access in its own dashboard and can disconnect at any time.
X-Bounty-Partner: {id}
Contact us
Who it's for
The API is open to every business on Bounty, from a single villa to a hotel chain. The key is free and takes a minute to issue in your dashboard. No developer? An iCal link or a ready-made integrator module is enough.
-
Management companies with dozens of villas and condos
Close dates and change prices for hundreds of units in one job, and pull occupancy from Airbnb and Booking.com via each unit's iCal.
POST /v1/bulk/calendarGET /v1/ical/{secret}.ics -
Hotels and aparthotels with their own PMS
Bounty guest bookings reach your PMS by webhook within seconds; units and rates are linked to yours by your own codes.
POST /v1/webhooksPUT /v1/external-refs -
Real estate and long-term rental agencies
Create listings with photos in a single upload, and a rerun never makes duplicates; long-term rental contracts work with the same key.
POST /v1/bulk/listings/v1/listings/{id}/contracts -
Rentals, tours and restaurants with their own CRM
Sessions and prices come from your CRM, guest bookings and messages go back into it.
/v1/listings/{id}/slotsGET /v1/dialogs -
Developers of PMS connectors and channel managers
One module for many partners: the app has its own permissions, and each business connects it with a single grant.
PUT /v1/apps/{code}/grant
Rules that protect your bookings
The key is shown once
Bounty stores only a fingerprint of the key. Revoke it with one click and it stops working at once.
Access by section
A calendar key has no reason to read messages or money. Grant only what's needed.
A retry never duplicates
With an Idempotency-Key header, the same request sent twice gives one record and the same response.
Dates in the listing's time zone
Check-in on 20 December means 20 December in Phuket, not in UTC. No “one day early” mistakes.
600 requests a minute
Per key. Beyond that, you get 429 and the time to wait before retrying.
/v1 doesn't break
New fields and endpoints appear; breaking changes ship only in /v2, and /v1 keeps working for at least a year after that.
User API
For your own scripts and assistants: search, bookings, favourites and messages on your behalf. A token is issued by a request with your password, with the access you choose.
POST /v1/me/api-tokens
Create a partner account and get Bounty guests' bookings straight into your system
API terms of use