Agoda Hotel Prices API
Look up live Agoda room availability and normalized rate plans for one hotel and stay.
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
Overview
Send your API key in X-API-Key. If you only have an Agoda URL, resolve it first with the
URL-to-ID endpoint.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | integer | Required | Positive numeric Agoda hotel ID |
| check_in | date | Required | YYYY-MM-DD; today through 365 days ahead |
| check_out | date | Required | After check-in; maximum stay 90 nights |
| adults | integer | Optional | Default 2; range 1–60 |
| rooms | integer | Optional | Default 1; range 1–9 |
| children | integer | Optional | Default 0; range 0–9. Child age defaults to 8 when children_ages is omitted or blank. |
| children_ages | string | Optional | Up to nine comma-separated integer ages 0–17, such as 5,8. Nonblank ages override children; omitted or blank uses the children count with age 8 for each child. The response search includes the effective children and children_ages. |
| currency | string | Optional | Default USD; three-letter currency code |
Response schema
price_per_room_per_night and stay_price each expose the tax-exclusive amount, taxes and fees, and Agoda's all-inclusive total. The top-level lowest_price is the cheapest all-inclusive whole-stay rate.
Sold-out stays
Sold out is a successful lookup
A valid stay with no bookable rates returns HTTP 200 with available: false, sold_out: true, no lowest_price, and room_types: [].
Availability and prices are live and can change between lookup and booking.
Errors
400 / 422: invalid dates, parameter ranges, child ages, hotel ID, or currency.
401 / 403: missing, invalid, or unauthorized API key.
502: Agoda could not provide room availability; retry once after a short delay.
503 / 504: temporary capacity or timeout condition. Honor Retry-After when present.
Error bodies use RFC 7807 application/problem+json. Only a 2xx response is data.
Use the same hotel_id for hotel details without dates. Find a hotel first with city search or hotel name lookup.