List test cohorts
curl --request GET \
--url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"cohorts": [
{
"id": "cohort_abc123",
"advertiserId": "12345",
"name": "West Coast Treatment Group",
"cohortType": "geographic",
"role": "TREATMENT",
"isActive": true,
"createdAt": "2025-01-15T10:30:00Z",
"updatedAt": "2025-01-20T14:45:00Z",
"estimatedSize": 50000
}
],
"total": 6
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Measurement
List test cohorts
List test cohorts for an advertiser.
GET
/
advertisers
/
{advertiserId}
/
test-cohorts
List test cohorts
curl --request GET \
--url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/test-cohorts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"cohorts": [
{
"id": "cohort_abc123",
"advertiserId": "12345",
"name": "West Coast Treatment Group",
"cohortType": "geographic",
"role": "TREATMENT",
"isActive": true,
"createdAt": "2025-01-15T10:30:00Z",
"updatedAt": "2025-01-20T14:45:00Z",
"estimatedSize": 50000
}
],
"total": 6
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Path Parameters
Unique identifier for the advertiser
Minimum string length:
1Example:
"12345"
Query Parameters
Filter by advertiser ID
Example:
"12345"
Filter by cohort role
Available options:
TREATMENT, CONTROL, OBSERVATION Filter by active status
Number of results to return (max 250)
Required range:
0 < x <= 250Example:
50
Number of results to skip for pagination
Required range:
0 <= x <= 9007199254740991Example:
0
Response
List test cohorts
Response containing a paginated list of test-cohort summaries