List measurement records

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

GET /api/v2/buyer/advertisers/{advertiserId}/measurement-records Lists the outcome records uploaded for an advertiser, with optional filtering by outcome type, geo, date range, media buy, and package. To read outcome counts beside each package’s daily spend, with the cost per outcome worked out, use cost per outcome in reporting instead of joining this list to spend yourself.

Request

curl "https://api.apostra.com/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	Earliest date, as `YYYY-MM-DD`
`endDate`	string	No	Latest date, as `YYYY-MM-DD`
`mediaBuyId`	string	No	Only records that name this media buy
`packageId`	string	No	Only records that name this package. Package ids are unique within a media buy, so pair it with `mediaBuyId`
`take`	integer	No	Page size, max 250 (default 50)
`skip`	integer	No	Offset for pagination (default 0)
`cursor`	string	No	Opaque cursor from `meta.pagination.nextCursor` of the previous page. Returns the page after it and takes the place of `skip`, which is ignored when `cursor` is set. Faster than `skip` for deep pages

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, ordered by timeWindowStart and then id. The total count and paging state are returned in the meta.pagination block (skip, take, total, hasMore); see Pagination. You can page two ways. Offset paging (take / skip) works as before. Cursor paging is quicker on large result sets: while meta.pagination.hasMore is true, meta.pagination.nextCursor holds the cursor for the next page. Send it back as cursor with the same filters and take. A page fetched with cursor reports skip: 0; use hasMore and nextCursor to continue, and treat the cursor as opaque. A cursor the API did not issue returns 400 VALIDATION_ERROR.

Errors

400 VALIDATION_ERROR — malformed startDate/endDate date, or a cursor the API did not issue.
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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

List measurement records

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