GET
# Agoda Hotel Prices API

Look up live Agoda room availability and normalized rate plans for one hotel and stay.

## 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](/docs/endpoints/agoda/hotel-url-to-id).

### 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](/docs/endpoints/agoda/hotel-details) without dates. Find a hotel first with [city search](/docs/endpoints/agoda/search) or [hotel name lookup](/docs/endpoints/agoda/hotel-lookup).

Request

```curl
curl 'https://api.stayapi.com/v1/agoda/hotel/prices?hotel_id=10884&check_in=2027-05-15&check_out=2027-05-17&adults=2&rooms=1&children_ages=5%2C8&currency=USD' -H 'X-API-Key: YOUR_API_KEY'
```

Response

```json
{
  "success": true,
  "hotel_id": 10884,
  "search": {
    "check_in": "2027-05-15",
    "check_out": "2027-05-17",
    "adults": 2,
    "rooms": 1,
    "children": 2,
    "children_ages": [5, 8]
  },
  "currency": "USD",
  "currency_symbol": "$",
  "available": true,
  "sold_out": false,
  "lowest_price": {
    "exclusive": 600.84,
    "taxes_and_fees": 124.36,
    "total": 725.20
  },
  "room_types": [{
    "room_id": 3122086,
    "name": "Banyan Pool Villa",
    "max_occupancy": 2,
    "available_rooms": 4,
    "bed_configuration": "1 king bed",
    "rates": [{
      "rate_plan_id": 1019134,
      "name": "Banyan Pool Villa",
      "occupancy": 2,
      "available_rooms": 4,
      "currency": "USD",
      "price_per_room_per_night": {
        "exclusive": 300.42,
        "taxes_and_fees": 62.18,
        "total": 362.60
      },
      "stay_price": {
        "exclusive": 600.84,
        "taxes_and_fees": 124.36,
        "total": 725.20
      },
      "breakfast_included": true,
      "free_cancellation": false,
      "cancellation_policy": "Non-refundable",
      "taxes_and_surcharges": ["City tax 1%", "Tax 17.7%"]
    }]
  }],
  "retrieved_at": "2026-08-19T10:30:00Z"
}
```

```json
{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request parameters",
  "instance": "/v1/agoda/hotel/prices",
  "provider": "agoda"
}
```
