Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/measurement-records Lists the outcome records uploaded for an advertiser, with optional filtering by outcome type, geo, and date range.

​
Request

curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/measurement-records?outcomeType=incremental_revenue&geos=US-CA,US-OR&startDate=2026-03-01&endDate=2026-03-31&take=50&skip=0" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath parameter — the owning advertiser
outcomeTypestringNoFilter by outcome type
geostringNoFilter by a single geo
geosstringNoComma-separated list of geos
startDatestringNoDate YYYY-MM-DD lower bound
endDatestringNoDate YYYY-MM-DD upper bound
takeintegerNoPage size, max 250 (default 50)
skipintegerNoOffset for pagination (default 0)

​
Response

[
  {
    "id": "mr_001",
    "advertiserId": "12345",
    "outcomeType": "incremental_revenue",
    "geo": "US-CA",
    "timeWindowStart": "2026-03-01",
    "timeWindowEnd": "2026-03-07",
    "value": 8450.75,
    "baselineValue": 7100.00,
    "confidenceInterval": 0.92,
    "source": "measured",
    "receivedAt": "2026-04-19T08:00:00Z",
    "lagDays": 7
  }
]
The data payload is the array of matching records. The total count and paging state are returned in the meta.pagination block — this endpoint uses offset pagination (take / skip); see Pagination.

​
Errors

  • 400 VALIDATION_ERROR — malformed startDate/endDate 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

Add more outcome records