---
title: "Get Page Freshness"
method: GET
path: "/freshness/{page}"
tags: ["FRESHNESS"]
---

# Get Page Freshness

`GET /freshness/{page}`

Freshness of the datasets a UI page depends on, plus a page rollup.

Returns 200 with null freshness (not 404) when a page's datasets have not
loaded yet, so the frontend can render a "no data yet" state. ``missing_tables``
lists the page's serving tables (``store:serving_table``) that have no freshness
row yet.

## Path parameters

- `page` string, required

## Response `200`

Successful Response

- PageFreshnessResponse — Per-page rollup: the page is as fresh as its stalest serving table.
  - `page` string, required
  - `oldest_watermark_ts` string, date-time, nullable
  - `max_freshness_age_seconds` integer, nullable
  - `last_update_ts` string, date-time, nullable
  - `tables` TableFreshness[]
    - `store` string, required
    - `serving_table` string, required
    - `pipeline` string, nullable
    - `freshest_writer` string, nullable
    - `last_update_ts` string, date-time, nullable
    - `freshness_watermark_ts` string, date-time, nullable
    - `freshness_age_seconds` integer, nullable
    - `measured_latency_seconds` integer, nullable
    - `last_status` string, nullable
    - `source` string
  - `datasets` DatasetFreshness[]
    - `dataset_type` string, required
    - `last_update_ts` string, date-time, nullable
    - `freshness_watermark_ts` string, date-time, nullable
    - `freshness_age_seconds` integer, nullable
    - `measured_latency_seconds` integer, nullable
    - `last_status` string, nullable
    - `source` string
  - `missing_tables` string[]

## Other responses

- `400` — Invalid page parameter
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/50769cbf05d5/schema)