---
title: "Data freshness"
method: GET
path: "/api/v1/freshness"
---

# Data freshness

`GET /api/v1/freshness`

## Request

- Base URL: `https://tv.madeinro.eu`
- URL: `https://tv.madeinro.eu/api/v1/freshness`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`

Age of the EPG and streaming snapshots. EPG refreshes 4x/day; feeds every 15 min.

## Response `200`

Freshness info.

- Freshness: Age of the underlying data. Use it to decide whether to trust cached answers.
  - `generated_at` string
  - `data_as_of` string
  - `epg_age_min` number: Minutes since the last EPG refresh.
  - `streaming_age_min` number: Minutes since the last streaming refresh.
  - `stale` boolean, required: True when data is older than the expected cadence.

---

[API](https://skmtc.dev/madeinro/apis/rotv-guide-api.md) · [All operations](https://skmtc.dev/madeinro/apis/rotv-guide-api/llms.txt) · [OpenAPI document](https://skmtc.dev/madeinro/apis/rotv-guide-api/revisions/7771a3ee9257?raw)