GET

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

GET https://api.stayapi.com/v1/agoda/hotel/prices

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.

Browse documentation