Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/measurement-freshness Checks for gaps in measurement data coverage relative to a flight schedule and the registered source cadence. Run this during flight to confirm data is actually arriving for the geos and weeks you expect.

​
Request

curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/measurement-freshness?flightStart=2026-03-01&flightEnd=2026-04-30&geos=US-CA,US-OR,US-WA" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath parameter — the owning advertiser
flightStartstringYesDate YYYY-MM-DD start of the flight window
flightEndstringNoDate YYYY-MM-DD end of the flight window. Defaults to now
geosstringYesComma-separated geos to check coverage for

​
Response

{
  "gaps": [
    {
      "source": "acme_orders",
      "sourceName": "Acme Orders",
      "outcomeType": "incremental_revenue",
      "cadence": "weekly",
      "lagWeeks": 1,
      "expectedWeekStart": "2026-04-01T00:00:00Z",
      "expectedWeekEnd": "2026-04-07T23:59:59Z",
      "geosMissing": ["US-WA"],
      "geosPresent": ["US-CA", "US-OR"],
      "daysOverdue": 12
    }
  ],
  "totalMissing": 1,
  "mostOverdue": {
    "source": "acme_orders",
    "sourceName": "Acme Orders",
    "outcomeType": "incremental_revenue",
    "cadence": "weekly",
    "lagWeeks": 1,
    "expectedWeekStart": "2026-04-01T00:00:00Z",
    "expectedWeekEnd": "2026-04-07T23:59:59Z",
    "geosMissing": ["US-WA"],
    "geosPresent": ["US-CA", "US-OR"],
    "daysOverdue": 12
  },
  "lastUploadDate": "2026-04-19T08:00:00Z",
  "baselineCoverage": {
    "weeksPresent": 7,
    "weeksExpected": 8,
    "geosPresent": 2,
    "geosExpected": 3
  }
}
gaps[] lists each source / week / geo combination where expected data has not arrived. totalMissing is the gap count; mostOverdue is the single gap with the highest daysOverdue (or null when there are none). lastUploadDate is the most recent record received (or null), and baselineCoverage summarizes how many expected weeks and geos are present (or null when no flight baseline is configured).

​
Errors

  • 400 VALIDATION_ERROR — missing flightStart or geos, or a malformed date.
  • 404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Measurement tasks

All measurement operations

Measurement overview

Pipeline, belief state, and concepts

Upload measurement records

Fill the gaps with outcome records