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.