Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/syndication-status Returns syndication status records for an advertiser, with optional filtering by resource type, resource ID, ADCP agent, enabled state, and status. Use this to confirm a toggle has reached COMPLETED, or to read the errorMessage on a FAILED record.

​
Request

curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/syndication-status?resourceType=AUDIENCE&status=COMPLETED&limit=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

ParamTypeRequiredNotes
advertiserIdstring (path)YesAdvertiser to query
resourceTypeenumNoAUDIENCE, EVENT_SOURCE, or CATALOG
resourceIdstringNoFilter to one resource
adcpAgentIdstringNoFilter to one ADCP agent
enabledenumNo"true" or "false" (string)
statusenumNoPENDING, SYNCING, COMPLETED, FAILED, or DISABLED
limitintegerNo1–100, default 50
offsetintegerNoDefault 0, for pagination

​
Response

{
  "items": [
    {
      "id": "1",
      "customerId": 7,
      "seatId": "12345",
      "resourceType": "AUDIENCE",
      "resourceId": "aud_88f0",
      "audienceId": "1",
      "eventSourceId": null,
      "catalogId": null,
      "adcpAgentId": "42",
      "adcpAgentAccountId": null,
      "enabled": true,
      "status": "COMPLETED",
      "errorMessage": null,
      "responseData": null,
      "createdAt": "2026-06-06T17:00:00.000Z",
      "updatedAt": "2026-06-06T17:02:11.000Z",
      "completedAt": "2026-06-06T17:02:11.000Z"
    }
  ],
  "total": 1
}
total is the count of records matching the query, independent of limit/offset. Page by raising offset.

​
Errors

  • 400 VALIDATION_ERROR — unknown resourceType or status, limit outside 1–100, or a missing advertiserId.
See Errors for the full error contract.

Syndication tasks

All syndication operations

Toggle syndication

Turn syndication on or off