---
title: "Samples"
method: GET
path: "/agent-hotels/destinations/{destination}/samples"
tags: ["agent-hotels"]
---

# Samples

`GET /agent-hotels/destinations/{destination}/samples`

Recently observed stays for a destination: Axel rate beside public rate.

A read of the shared price ledger. It never starts supplier pricing, so
the public destination pages can call it on every render.

## Path parameters

- `destination` string, required

## Query parameters

- `max_age_days` integer
- `limit` integer

## Response `200`

Successful Response

- HotelDestinationSamples — Recently observed stays for a destination; a read of the rate ledger. Nothing here starts a supplier search. Every row was priced earlier by an ordinary hotel search and is shown with the date it was observed.
  - `destination` HotelCatalogDestination, required
    - `id` string, required
    - `name` string, required
    - `country` string, required
    - `parent_id` string, nullable
    - `has_areas` boolean
    - `scope` string, nullable
    - `aliases` string[]
    - `hotel_count` integer, nullable
  - `samples` HotelStaySample[]
    - `hotel` HotelStaySampleHotel, required
      - `id` integer, required
      - `name` string, required
      - `city` string, nullable
      - `country` string, nullable
      - `stars` number, nullable
      - `chain` 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
      - `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
  - `observed_window_days` integer, required
  - `generated_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-09-30** `d698bc4c58ea` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/agent-hotels/destinations/:destination/samples/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/8f7eca7ced4d?raw)