Freshness and provenance

Understand when cinema data was observed and updated at its source.

Every response includes a top-level freshness.observedAt. This is the time represented by the latest successful canonical ingestion, not the time you made the API request.

Cinema, chain, film and showtime records also include provenance:

{
  "provider": "provider-name",
  "externalId": "source-record-id",
  "observedAt": "2026-07-28T09:00:00.000Z",
  "sourceUpdatedAt": "2026-07-28T08:45:00.000Z"
}

sourceUpdatedAt appears only when the upstream provider supplies a trustworthy timestamp. Use observedAt as the consistent lower bound when making cache and stale-data decisions.

The ingestion objective is a valid provider snapshot every 24 hours. A snapshot older than 26 hours is a freshness breach. A failed or anomalous collection does not erase the last valid snapshot: the existing records remain queryable while their timestamp makes the degradation visible.