# Agoda Hotel Rooms API Documentation

<p><strong>Agoda Hotel Rooms API Documentation</strong> Retrieve the room types of one Agoda hotel for a stay: for each room the id, name, size in square meters, features, facilities, up to 10 images, review score and every offer with the nightly price including taxes and fees, original price, discount percent, free cancellation, breakfast, pay later, cancellation policy and benefits. Prices are in USD. Sold-out rooms carry sold_out true. A hotel without any room for the dates is a not found error that is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/agoda-api/agoda_rooms](https://scrappa.co/docs/agoda-api/agoda_rooms)
- **API group:** Agoda API
- **Endpoint:** `GET https://scrappa.co/api/agoda/rooms`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hotel_id` | integer | Yes | Agoda hotel id from the suggest or search endpoint. Example: 44842960. |
| `city_id` | integer | Yes | Agoda city id of the hotel. Example: 9395. |
| `country_id` | integer | Yes | Agoda country id of the hotel, returned by the suggest endpoint. Example: 106 for Thailand. |
| `check_in` | string | Yes | Check-in date, YYYY-MM-DD, today or later. Example: 2027-03-14. |
| `check_out` | string | Yes | Check-out date, YYYY-MM-DD, after check-in, at most 30 nights. Example: 2027-03-16. |
| `adults` | integer | No | Number of adults, 1 to 30. Defaults to 2. |
| `rooms` | integer | No | Number of rooms, 1 to 9. Defaults to 1. |
| `children_ages` | string | No | Comma-separated ages of the children, each 0 to 17, up to 6. Example: 5,7. |

## Example response

```json
{
    "data": {
        "rooms": [
            {
                "id": 753393726,
                "name": "Deluxe Twin Room",
                "images": [
                    "https://pix8.agoda.net/hotelImages/44842960/753393726/7fc1f6ac70063f61f85d294c50cf8cd5.jpeg?ce=2&s=800x600",
                    "https://q-xx.bstatic.com/xdata/images/hotel/840x460/491809631.jpg?k=36b4461e4b05117c199458244c2e3cfa11d3822e094fa0e92192ee7f78c0f104&o="
                ],
                "offers": [
                    {
                        "benefits": [
                            "Breakfast available (USD\u00a021 / person)",
                            "Non-refundable (Low price!)",
                            "Book and pay now",
                            "Complimentary mini bar"
                        ],
                        "currency": "USD",
                        "pay_later": false,
                        "price_per_night": 127,
                        "free_cancellation": false,
                        "breakfast_included": false,
                        "cancellation_policy": "Non-refundable (Low price!)"
                    },
                    {
                        "benefits": [
                            "Breakfast included",
                            "Non-refundable (Low price!)",
                            "Book and pay now",
                            "Complimentary mini bar"
                        ],
                        "currency": "USD",
                        "pay_later": false,
                        "price_per_night": 141,
                        "free_cancellation": false,
                        "breakfast_included": true,
                        "cancellation_policy": "Non-refundable (Low price!)"
                    }
                ],
                "features": [
                    "Max 2 adults",
                    "2 single beds"
                ],
                "size_sqm": 44,
                "facilities": [
                    "City view",
                    "Bathtub"
                ],
                "review_score": 9.221
            },
            {
                "id": 753391914,
                "name": "Deluxe King Room",
                "images": [
                    "https://pix8.agoda.net/hotelImages/44842960/753391914/7d8a5a27b41e01e34d03d15ba5903da7.jpeg?ce=2&s=800x600",
                    "https://q-xx.bstatic.com/xdata/images/hotel/840x460/491805016.jpg?k=82880f156f1e42ee048da1801e294a2cdda4742c4edb1cf4b065af1b0383f8ce&o="
                ],
                "offers": [
                    {
                        "benefits": [
                            "Breakfast available (USD\u00a021 / person)",
                            "Non-refundable (Low price!)",
                            "Book and pay now",
                            "Complimentary mini bar"
                        ],
                        "currency": "USD",
                        "pay_later": false,
                        "price_per_night": 127,
                        "free_cancellation": false,
                        "breakfast_included": false,
                        "cancellation_policy": "Non-refundable (Low price!)"
                    },
                    {
                        "benefits": [
                            "Breakfast included",
                            "Non-refundable (Low price!)",
                            "Book and pay now",
                            "Complimentary mini bar"
                        ],
                        "currency": "USD",
                        "pay_later": false,
                        "price_per_night": 141,
                        "free_cancellation": false,
                        "breakfast_included": true,
                        "cancellation_policy": "Non-refundable (Low price!)"
                    }
                ],
                "features": [
                    "Max 2 adults",
                    "1 king bed"
                ],
                "size_sqm": 44,
                "facilities": [
                    "City view",
                    "Bathtub"
                ],
                "review_score": 9.378
            }
        ],
        "check_in": "2027-03-14",
        "currency": "USD",
        "hotel_id": 44842960,
        "check_out": "2027-03-16",
        "hotel_name": "Grande Centre Point Surawong Bangkok",
        "free_cancellation_until": "2027-03-07"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "hotel_rooms"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The hotel is unknown or has no room for the dates. This response is not billable. |
| 503 | Service Unavailable | Agoda could not be reached or answered with an unexpected shape. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)