Freshness

GET /v1/states/{factStateVersionId}/freshness

Every exact state is given a freshness horizon (fresh_until) at the moment it's created. This route tells you whether that horizon has passed.

Response — FreshnessVerdictV1

• FRESH — still within its horizon.
• STALE — horizon has passed; a revalidation is expected to be in flight or pending.
• UNKNOWN — freshness cannot currently be determined.

Fast Reality default

A single-surface, fast-changing fact defaults to OBSERVED assurance, not VERIFIED — promotion requires policy-defined, same-scope confirmation, not a freshness check alone.

Not cached as immutable

Unlike the exact-state route, freshness is re-evaluated at read time and is never cached as immutable.