# Stored rates: `GET /v1/rates/stored`

Cost: free (0 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/stored-rates

Stored-rate lookup with explicit freshness metadata.

Parameters:

- `token` (string; required; min length 8): Google property token whose rates have already been collected into stored rates (for example by a `POST /v1/jobs` batch).
- `start` (string (date) | null; optional): Inclusive first stay date.
- `end` (string (date) | null; optional): Inclusive last stay date.
- `limit` (integer; optional; default 500; min 1, max 2000)

Response fields:

- `source` (string; required; one of google_hotels)
- `source_property_id` (string; required): The requested token.
- `count` (integer; required)
- `last_observed_at` (string | null; required): Timestamp string, e.g. `2026-08-10 14:05:00.123456+00`.
- `last_success_at` (string | null; required): Timestamp string, e.g. `2026-08-10 14:05:00.123456+00`.
- `age_seconds` (integer | null; required)
- `freshness` (string; required; one of missing, fresh, stale, expired): `fresh` <= 24 h, `stale` <= 48 h, `expired` older, `missing` when never collected.
- `rates` (array of object; required)
  - `rates[].property_name` (string; required)
  - `rates[].stay_date` (string (date); required)
  - `rates[].occupancy_key` (string; required): e.g. `adults=2`
  - `rates[].los` (integer; required)
  - `rates[].rate` (number | null; required)
  - `rates[].rate_base` (number | null; required)
  - `rates[].rate_before_taxes_with_fees` (number | null; required)
  - `rates[].rate_total` (number | null; required)
  - `rates[].tax` (number | null; required)
  - `rates[].fees` (number | null; required)
  - `rates[].currency` (string; required)
  - `rates[].market` (string | null; required)
  - `rates[].rates_include_tax` (boolean; required)
  - `rates[].min_length_of_stay` (integer | null; required)
  - `rates[].observed_at` (string; required): Timestamp string, e.g. `2026-08-10 14:05:00.123456+00`.
  - `rates[].last_changed_at` (string; required): Timestamp string, e.g. `2026-08-10 14:05:00.123456+00`.
  - `rates[].collection_id` (string; required)
  - `rates[].observation_id` (string; required)
  - `rates[].provenance` (object; required): Provenance of one calendar row.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
