Push rates (async)

POST

/api/v1/push/rates

Push per-occupancy pricing for rooms.

Each entry defines a meal_plan_code (EP, CP, MAP, AP)
and prices per occupancy (adults_1 … adults_10,
children_1 … children_10).

Fields you omit are left unchanged (COALESCE semantics).
So you can push only adults_2 to change the price for 2-adult
bookings without touching other occupancies.

Returns a job_id (string, e.g. "rates_1_1703123456789").
Poll /api/v1/rates/status?job_id=<id>.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Rates push job accepted

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/push/rates' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ota_property_id": "HOTEL12345",
    "rates": [
        {
            "ota_room_code": "DLX_KING_001",
            "meal_plan_code": "EP",
            "adults_1": 1200,
            "adults_2": 1500,
            "adults_3": 1800,
            "children_1": 200,
            "children_2": 400
        },
        {
            "ota_room_code": "STD_QUEEN_002",
            "meal_plan_code": "CP",
            "adults_2": 2000
        }
    ]
}'

Response Example

202 - Success

{
    "status": true,
    "message": "Rates push started. Job ID rates_1_1703123456789.",
    "job_id": "rates_1_1703123456789"
}

Modified at 2026-11-12 09:12:10

Push inventory (async)

Push inventory overrides (async)