Reservit API technical guide
For administrators and technical users connecting third-party modules to Reservit.
Overview
The Reservit API is a REST-based interface that allows authorised third-party applications to read and write data in a Reservit property account. All API requests must be authenticated using an API key generated from within the Reservit administration panel. Requests are made over HTTPS and responses are returned in JSON format.
Authentication
Include your Reservit API key in the X-Api-Key header of every request. Example: X-Api-Key: <your-reservit-api-key>. Keys must be kept confidential. If a key is compromised, revoke it from the Reservit admin panel and generate a new one immediately.
Core endpoint categories
- Reservations: GET/POST/PATCH operations on reservation records. Includes arrival/departure, room type, rate plan, guest details, channel of origin, payment status.
- Rates: GET current rates; POST rate updates to specific date ranges and room types. Required for Revenue Optimizer and Smart Pricing modules.
- Guest profiles: GET guest profile by reservation or guest ID; POST profile updates. Required for Guest Portal and CRM Link modules.
- Channels: GET connected channel list and status. Read-only; channel connections are managed within the Reservit channel manager UI.
- Reports: GET night audit data, pickup report, occupancy summary. Required for Accounting Sync and Reporting Plus modules.
- Webhooks: Register a webhook endpoint URL for event-based notifications (new reservation, checkout, cancellation). Required for Email Automation module.
Rate limiting
Reservit applies rate limits per API key. Exceeding the limit returns HTTP 429. Implement exponential back-off: wait 1s on first 429, 2s on second, 4s on third, etc. Batch date-range requests where possible rather than calling per room-night to minimise API call volume.
Error handling
| HTTP Status | Meaning | Action |
|---|---|---|
| 200/201 | Success | Process response normally |
| 400 | Bad request — malformed payload | Check request structure against API docs |
| 401 | Unauthorised — invalid API key | Verify API key is correct and not revoked |
| 403 | Forbidden — insufficient permissions | Check API key permission scopes in Reservit |
| 404 | Resource not found | Check reservation ID / rate plan ID |
| 429 | Rate limit exceeded | Implement exponential back-off |
| 500/503 | Reservit server error | Retry after 60 seconds; contact Reservit support if persistent |
Testing and sandbox
Reservit provides a sandbox environment for API testing on certain plan tiers. Check with your Reservit account manager for sandbox access. ReserveWithIt runs integration tests against the Reservit sandbox before each module release and after each Reservit API update notification.