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

# Get Page Freshness

`GET /freshness/{page}`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/freshness/{page}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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
    - `last_attempt_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

## Changes

- **2026-08-19** `6aa0788aa5dc`: 1 info
  - added the optional property `datasets/items/last_attempt_ts` to the response with the `200` status
- **2026-08-08** `103580dad816`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/freshness/:page/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)