Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/test-cohorts/{cohortId} Returns the full test cohort resource, including its targeting definition.

​
Request

curl https://api.interchange.io/api/v2/buyer/advertisers/12345/test-cohorts/cohort_abc123 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath parameter — the owning advertiser
cohortIdstringYesPath parameter — the cohort ID

​
Response

{
  "id": "cohort_abc123",
  "advertiserId": "12345",
  "name": "West Coast Treatment Group",
  "description": "Users in CA, OR, WA receiving full ad exposure",
  "cohortType": "geographic",
  "role": "TREATMENT",
  "definition": { "type": "geo_region", "regions": ["US-CA", "US-OR", "US-WA"] },
  "estimatedSize": 50000,
  "isActive": true,
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-20T14:45:00Z"
}

​
Errors

  • 404 NOT_FOUND — cohortId (or 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

Update test cohort

Change definition or role