Get data freshness metrics

Returns data quality metrics. Two counts are reported side by side and they are not interchangeable: confirmed_* counts offers whose published terms the verification store can source to a read that confirmed them, and stamped_* counts offers by the catalogue date beside the entry, which records when it was last written and is not a confirmation. freshness_score is computed from the confirmed count; the catalogue-date share is published separately as stamp_score.

get/api/freshness

Request

  • Base URL: https://agentdeals.dev
  • URL: https://agentdeals.dev/api/freshness
  • Auth: none required

Response

Data freshness metrics

total_offersinteger
stamped_within_7_daysinteger

Offers whose catalogue date (verifiedDate) falls within 7 days. The catalogue date records when the entry was last written and is not a confirmation.

stamped_within_30_daysinteger

Offers whose catalogue date falls within 30 days.

stamped_within_90_daysinteger

Offers whose catalogue date falls within 90 days. This count was published as verified_within_90_days until 2026-09-14.

stamped_within_180_daysinteger

Offers whose catalogue date falls within 180 days.

confirmed_within_7_daysinteger

Offers whose published terms the verification store can source to a read that confirmed them within 7 days.

confirmed_within_30_daysinteger

Offers confirmed by a read within 30 days.

confirmed_within_90_daysinteger

Offers confirmed by a read within 90 days. freshness_score is computed from this.

confirmed_within_180_daysinteger

Offers confirmed by a read within 180 days.

offers_holding_a_confirmationinteger

Offers for which the verification store holds any confirmation at all.

oldest_confirmation_heldstring date nullable

The oldest confirmation still held for any offer. This is not the date the store opened — a confirmation superseded by a later read is no longer held.

attempted_within_90_daysinteger

Offers the verification store attempted to re-read within 90 days, whether or not the read confirmed anything. Read against confirmed_within_90_days this separates offers we have not reached from offers we reached without confirming.

freshness_scoreinteger

confirmed_within_90_days as a percentage of total_offers — the share of the catalogue whose published terms we can source to a read that confirmed them. This field reported the catalogue-date share until 2026-09-14; that share is now published as stamp_score.

stamp_scoreinteger

stamped_within_90_days as a percentage of total_offers.

Changes

No recorded changes to this operation across all 1 revision of this API.