---
title: "Get dataset freshness"
method: GET
path: "/v1/status/freshness"
tags: ["Status"]
---

# Get dataset freshness

`GET /v1/status/freshness`

## Request

- Base URL: `https://api.liquidcompute.co`
- URL: `https://api.liquidcompute.co/v1/status/freshness`
- Auth: API key in header `X-API-Key`

Returns when each dataset last updated successfully and when its next
update is expected: one scheduled interval after the last. A
`next_expected_at` in the past means the update is overdue. A dataset
that has never updated is `null`.

Open to any valid API key; no entitlement family is required.

## Response `200`

Freshness per dataset.

- FreshnessResponse
  - `custom_index` DatasetFreshness, nullable, required: A dataset's last successful update and when the next is due; null when it has never updated.
    - `last_success_at` string, date-time, required
    - `next_expected_at` string, date-time, required
  - `gpu_prices` DatasetFreshness, nullable, required: A dataset's last successful update and when the next is due; null when it has never updated.
    - `last_success_at` string, date-time, required
    - `next_expected_at` string, date-time, required
  - `series` DatasetFreshness, nullable, required: A dataset's last successful update and when the next is due; null when it has never updated.
    - `last_success_at` string, date-time, required
    - `next_expected_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.
- `502`: Upstream service or gateway configuration failure.
- `503`: API-key validation is temporarily unavailable.

---

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