1. Overview
The Pricing API is an API used to retrieve and update rate information in AirHost from external systems.
By using this API, AirHost can act as a hub to centrally manage rate distribution to multiple OTAs (e.g., Airbnb, Booking.com).
2. Main Use Cases
Integration with in-house rate optimization logic (RMS functionality)
Bulk rate updates across multiple properties and room types
Rate control via external tools
3. Available Functions
Rate Plan Related
Retrieve rate plan list
Retrieve rate plan details
Rate Related
Retrieve daily rates
Update daily rates
4. Supported Endpoints
🔹 Rate (Main Functions)
GET /api/public/rate_plans
GET /api/public/rate_plans/{id}
GET /api/public/rate_plans/{id}/rates
PATCH /api/public/rates
🔹 Property & Room Type Information (Supporting)
GET /api/public/properties
GET /api/public/properties/{id}
※ Only properties and room types with Pricing API enabled will be returned.
5. Implementation Overview
When using the Pricing API, store the following data obtained from AirHost API into your external system database:
Property & room type information
Rate plan information
Daily rate information
Rather than querying the API in real time for every request, it is recommended to keep the necessary data in your external system and synchronize it periodically with AirHost using scheduled sync processes.
🔁 Data Flow Overview
⚠️ Implementation Notes
The retrieved property & room type information, rate plan information, and rate data should be stored in the external system’s local database.
It is not recommended to query the API in real time for every request.
Data should be updated through scheduled synchronization processes.
6. Process Flow
1. Retrieve and store property & room type information
GET /api/public/properties
GET /api/public/properties/{id}
Store the retrieved data in the local database.
2. Retrieve and store rate plan information
GET /api/public/rate_plans
GET /api/public/rate_plans/{id}
Manage which rate plans should be updated.
3. Retrieve and store daily rate information
GET /api/public/rate_plans/{id}/rates
Retrieve current rate data and store it in the external system.
4. Calculate rates in the external system
Rates are determined using RMS or custom logic based on demand, occupancy, and other factors.
5. Update rates
PATCH /api/public/rates
Send updated rates (target dates and prices) to AirHost.
6. Rate distribution to OTAs
Rates updated in AirHost are automatically synchronized and distributed to each OTA through AirHost’s standard processing.
7. Design Principles & Limitations
This API is designed to be simple and focused on rate updates only.
The following are not supported:
Inventory updates
Minimum stay settings (Min Stay)
CTA / CTD restrictions
OTA-specific controls
8. API Specification
For detailed request and response specifications, please refer to: