---
title: "Latest build per model and whether the data is stale (env: this deployment)."
method: GET
path: "/api/v1/admin/metrics/freshness"
tags: ["Metrics Admin"]
---

# Latest build per model and whether the data is stale (env: this deployment).

`GET /api/v1/admin/metrics/freshness`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/admin/metrics/freshness`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

## Query parameters

- `tz` string, nullable
- `include_internal` '0' | '1', nullable

## Response `200`

OK

- FreshnessResponse
  - `env` 'production' | 'staging' | 'local' | 'test', required
  - `generated_at` string, date-time, required
  - `is_stale` boolean, required
  - `last_run` LastRun, required
    - `built_by_env` string, required
    - `finished_at` string, date-time, nullable, required
    - `run_id` string, required
    - `status` string, required
  - `meta` ResponseMeta, required: The zone the answer's dates are in (ruling 11). tz_applied is false where the data is UTC by nature (/freshness, /exports).
    - `tz` string, required
    - `tz_applied` boolean
  - `models` ModelFreshness[], required
    - `built_by_env` string, required
    - `finished_at` string, date-time, nullable, required
    - `is_stale` boolean, required
    - `last_success_at` string, date-time, nullable, required
    - `max_business_day` string, date, nullable, required
    - `max_event_ts` string, date-time, nullable, required
    - `model` string, required
    - `run_id` string, required
    - `stale_after_hours` 2 | 26, required
    - `status` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `503`: Service Unavailable

---

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