> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List measurement records

> Query uploaded measurement records by outcome, geo, and date

`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

<CodeGroup>
  ```bash curl theme={null}
  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"
  ```
</CodeGroup>

## 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

```json theme={null}
[
  {
    "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](/v2/reference/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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Measurement tasks" href="/v2/buyer/measurement/tasks" icon="list-check">
    All measurement operations
  </Card>

  <Card title="Measurement overview" href="/v2/guides/measurement-incrementality" icon="chart-line">
    Pipeline, belief state, and concepts
  </Card>

  <Card title="Upload measurement records" href="/v2/buyer/measurement/tasks/upload-measurement-records" icon="upload">
    Add more outcome records
  </Card>
</CardGroup>