List measurement records

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

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path parameter — the owning advertiser
`outcomeType`	string	No	Filter by outcome type
`geo`	string	No	Filter by a single geo
`geos`	string	No	Comma-separated list of geos
`startDate`	string	No	Date `YYYY-MM-DD` lower bound
`endDate`	string	No	Date `YYYY-MM-DD` upper bound
`take`	integer	No	Page size, max 250 (default 50)
`skip`	integer	No	Offset 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 account.

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

Get test cohort List measurement sources

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Measurement tasks

Measurement overview

Upload measurement records

​Request

​Parameters

​Response

​Errors

​Related

Measurement tasks

Measurement overview

Upload measurement records

Request

Parameters

Response

Errors

Related