> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /agoda/hotels/rooms

> Get the live room rate grid for an Agoda hotel by property id (or hotel URL) for specific check-in / check-out dates and occupancy. Returns each available room type with its size, view and bed features, amenities, photos, guest review score and the list of bookable rate offers. Every offer carries the nightly price and currency, meal plan, cancellation policy, pay-later / pay-at-hotel flags, whether a credit card is required, the supplier and how many rooms are left. Prices and availability depend on the requested dates and occupancy.

**Price:** 10 credits per 14 results

**⚠️ Common errors:** 412: Hotel not found (well-formed but nonexistent property id)



## OpenAPI

````yaml /openapi/travel-hospitality.json post /api/agoda/hotels/rooms
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/agoda/hotels/rooms:
    post:
      tags:
        - /agoda
      summary: /agoda/hotels/rooms
      description: >-
        Get the live room rate grid for an Agoda hotel by property id (or hotel
        URL) for specific check-in / check-out dates and occupancy. Returns each
        available room type with its size, view and bed features, amenities,
        photos, guest review score and the list of bookable rate offers. Every
        offer carries the nightly price and currency, meal plan, cancellation
        policy, pay-later / pay-at-hotel flags, whether a credit card is
        required, the supplier and how many rooms are left. Prices and
        availability depend on the requested dates and occupancy.


        **Price:** 10 credits per 14 results


        **⚠️ Common errors:** 412: Hotel not found (well-formed but nonexistent
        property id)
      operationId: __api_agoda_hotels_rooms_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgodaHotelsRoomsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AgodaRoom'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AgodaHotelsRoomsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        hotel:
          type: string
          minLength: 1
        check_in:
          type: string
        check_out:
          type: string
        adults:
          type: integer
          minimum: 1
          default: 2
        children_ages:
          items:
            type: integer
          type: array
          default: []
        rooms:
          type: integer
          minimum: 1
          default: 1
        count:
          type: integer
          minimum: 1
      type: object
      required:
        - hotel
        - check_in
        - check_out
        - count
    AgodaRoom:
      properties:
        '@type':
          type: string
          default: AgodaRoom
        id:
          type: string
        room_type:
          anyOf:
            - type: string
            - type: 'null'
        is_sold_out:
          anyOf:
            - type: boolean
            - type: 'null'
        room_size:
          anyOf:
            - type: string
            - type: 'null'
        review_score:
          anyOf:
            - type: number
            - type: 'null'
        features:
          items:
            type: string
          type: array
          default: []
        facilities:
          items:
            type: string
          type: array
          default: []
        amenities:
          items:
            type: string
          type: array
          default: []
        images:
          items:
            type: string
          type: array
          default: []
        min_price:
          anyOf:
            - type: number
            - type: 'null'
        offers:
          items:
            $ref: '#/components/schemas/AgodaRoomOffer'
          type: array
          default: []
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    AgodaRoomOffer:
      properties:
        '@type':
          type: string
          default: AgodaRoomOffer
        rate_plan_id:
          anyOf:
            - type: integer
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        price_text:
          anyOf:
            - type: string
            - type: 'null'
        price_info:
          anyOf:
            - type: string
            - type: 'null'
        meal:
          anyOf:
            - type: string
            - type: 'null'
        is_breakfast_included:
          anyOf:
            - type: boolean
            - type: 'null'
        cancellation:
          anyOf:
            - type: string
            - type: 'null'
        is_free_cancellation:
          anyOf:
            - type: boolean
            - type: 'null'
        is_pay_later:
          anyOf:
            - type: boolean
            - type: 'null'
        is_pay_at_hotel:
          anyOf:
            - type: boolean
            - type: 'null'
        is_credit_card_required:
          anyOf:
            - type: boolean
            - type: 'null'
        supplier_id:
          anyOf:
            - type: integer
            - type: 'null'
        remaining_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        benefits:
          items:
            type: string
          type: array
          default: []
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````