Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/test-cohorts Lists test cohorts for an advertiser — the treatment, control, and observation arms used in incrementality tests. Filter by role and active status.

​
Request

curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/test-cohorts?role=TREATMENT&isActive=true&take=50&skip=0" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath parameter — the owning advertiser
roleenumNoTREATMENT, CONTROL, or OBSERVATION
isActivebooleanNoFilter by active status
takeintegerNoPage size, max 250 (default 50)
skipintegerNoOffset for pagination (default 0)

​
Response

{
  "cohorts": [
    {
      "id": "cohort_abc123",
      "advertiserId": "12345",
      "name": "West Coast Treatment Group",
      "cohortType": "geographic",
      "role": "TREATMENT",
      "estimatedSize": 50000,
      "isActive": true,
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-20T14:45:00Z"
    }
  ],
  "total": 6
}
Returns compact cohort summaries plus a total count matching the query. Summaries omit definition and description — use Get test cohort for the full resource. This endpoint is offset-paginated; see Pagination for the meta.pagination envelope fields.

​
Errors

  • 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

Create test cohort

Define a new arm