---
title: "Stays"
method: GET
path: "/agent-hotels/hotels/{hotel_id}/stays"
tags: ["agent-hotels"]
---

# Stays

`GET /agent-hotels/hotels/{hotel_id}/stays`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/agent-hotels/hotels/{hotel_id}/stays`
- Auth: none declared

Every stay priced for one hotel in the window: Axel rate beside public.

A read of the shared price ledger for the hotel's own public page. It
never starts supplier pricing; the page revalidates every 15 minutes.

## Path parameters

- `hotel_id` integer, required

## Query parameters

- `max_age_days` integer

## Response `200`

Successful Response

- HotelStays: Every stay priced for one hotel in the window; a read of the rate ledger. The hotel's own public page. Nothing here starts a supplier search: each stay was priced earlier by the nightly sweep or a traveler's search and is shown with the date it was observed, beside the public rate for the same stay when one was seen.
  - `hotel` HotelStaysHotel, required: The hotel a page is about: the catalog property, its photo and a short amenity list.
    - `id` integer, required
    - `name` string, required
    - `city` string, nullable
    - `country` string, required
    - `address` string, nullable
    - `stars` number, nullable
    - `chain` string, nullable
    - `latitude` number, required
    - `longitude` number, required
    - `photo` string, nullable
    - `amenities` string[]
  - `stays` HotelStaySample[]
    - `hotel` HotelStaySampleHotel, required
      - `id` integer, required
      - `name` string, required
      - `city` string, nullable
      - `country` string, nullable
      - `stars` number, nullable
      - `chain` string, nullable
      - `photo` string, nullable
    - `stay` HotelStaySampleStay, required
      - `check_in` string, date, required
      - `check_out` string, date, required
      - `nights` integer, required
      - `adults` integer, required
      - `rooms` integer, required
    - `axel` HotelStaySampleAxel, required
      - `total` number, required
      - `currency` string
      - `nightly` number, nullable
      - `fees_at_property` number, nullable
      - `room_name` string, nullable
      - `is_refundable` boolean, nullable
      - `source` string, required
      - `observed_at` string, date-time, required
    - `public` HotelStaySamplePublic
      - `total` number, required
      - `source` string, required
      - `observed_at` string, date-time, required
    - `saving` HotelStaySampleSaving
      - `amount` number, required
      - `percent` number, required
  - `summary` HotelStaysSummary, required
    - `stays` integer, required
    - `deals` integer, required
    - `best_saving` HotelStaySampleSaving
      - `amount` number, required
      - `percent` number, required
    - `min_total` number, nullable
    - `min_nightly` number, nullable
  - `observed_window_days` integer, required
  - `generated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-10** `e1fd53f6044d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/agent-hotels/hotels/:hotel_id/stays/get.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/8824999a7a0a?raw)