API Documentation

Canonical HotelBinder supplier API reference.

Quick Start

Base URL

https://api.hotelbinder.com

Authentication

Headers:
  X-API-Key: your-api-key
  X-API-Secret: your-api-secret
  X-Environment: sandbox | production
  Idempotency-Key: required-for-checkRates-booking-cancel

Canonical Endpoints

Search Hotels

POST /api/v1/search

Example body

{
  "hotelId": "hbr-hotel-id",
  "hotelIds": [
    "hbr-hotel-id-1",
    "hbr-hotel-id-2"
  ],
  "city": "Los Angeles",
  "countryCode": "US",
  "limit": 20
}

Hotel Content

GET /api/v1/hotels/{hotelId}

Availability

POST /api/v1/availability

Example body

{
  "hotelId": "hbr-hotel-id",
  "checkIn": "2026-07-01",
  "checkOut": "2026-07-02",
  "adults": 2,
  "children": []
}

Check Rates

POST /api/v1/checkRates

Example body

{
  "hotelId": "hbr-hotel-id",
  "roomId": "room-id",
  "rateId": "rate-id",
  "checkIn": "2026-07-01",
  "checkOut": "2026-07-02",
  "adults": 2,
  "quantity": 1,
  "expectedSupplierCostCents": 12500,
  "currency": "EUR"
}

Book Hold

POST /api/v1/booking

Example body

{
  "checkRateId": "check-rate-id",
  "holdToken": "opaque-hold-token",
  "guest": {
    "name": "Ada Lovelace",
    "email": "ada@example.com"
  },
  "payment": {
    "status": "AUTHORIZED",
    "reference": "roomundo-payment-reference"
  }
}

Cancel Booking

POST /api/v1/cancel

Example body

{
  "bookingId": "hbr-booking-id",
  "reason": "CUSTOMER_REQUEST"
}

Integration Support

For API support, integration help, or questions, contact us at info@visit-online.nl