Client Hotel Booking API
RateNet exposes a GraphQL API for hotel availability and booking. This documentation covers the Client Hotel Booking API — the integration path for travel agencies, OTAs, and any server-side application that needs to search availability and create bookings using a Client Account API key.
Who this is for
This API is designed for Client Accounts authenticating with X-API-Key. It is not intended for tenant administrators or the RateNet UI (which use JWT). If you are building admin tooling or a custom frontend, see your operator for internal access.
-
Authenticate, check availability for specific hotels, and make a test booking in minutes.
-
Client Account API keys (
X-API-Key) are the only supported auth method for API integrations. -
Complete reference for all client-accessible operations:
checkHotels,checkRate,bookRate,cancelBooking,amendBooking, and more. -
End-to-end booking lifecycle with full request and response examples.
Base URL
All requests are served from the base URL provided by your operator:
The GraphQL endpoint is POST /graphql, accepting Content-Type: application/json.
Authentication
All API integrations use a Client Account API key in the X-API-Key header. Keys are provisioned by your tenant admin when they create a Client Account for your integration. See Authentication for details.
Available operations
| Operation | Type | Description |
|---|---|---|
checkHotels | Query | Synchronous availability check for specific hotel codes |
checkRate | Query | Re-validate a rate in real time before booking |
booking | Query | Retrieve a single booking by reference |
checkBooking | Query | Public booking status lookup (no auth required) |
bookRate | Mutation | Create a hotel booking |
cancelBooking | Mutation | Cancel an existing booking |
amendBooking | Mutation | Amend occupancy or holder details |