Get syndication status

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

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.apostra.com/api/v2/buyer/advertisers/12345/syndication-status?resourceType=AUDIENCE&status=COMPLETED&limit=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Param	Type	Required	Notes
`advertiserId`	string (path)	Yes	Advertiser to query
`resourceType`	enum	No	`AUDIENCE`, `EVENT_SOURCE`, or `CATALOG`
`resourceId`	string	No	Filter to one resource
`adcpAgentId`	string	No	Filter to one ADCP agent
`enabled`	enum	No	`"true"` or `"false"` (string)
`status`	enum	No	`PENDING`, `SYNCING`, `COMPLETED`, `FAILED`, or `DISABLED`
`limit`	integer	No	`1`–`100`, default `50`
`offset`	integer	No	Default `0`, for pagination

Response

{
  "items": [
    {
      "id": "1",
      "customerId": 7,
      "advertiserId": "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. For a seller that has no separate agent record, adcpAgentId is the seller’s public key (for a hosted Storefront, storefront-<platformId>) instead of a numeric id.

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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get syndication status

Request

Parameters

Response

Errors

Syndication tasks

Toggle syndication

​Request

​Parameters

​Response

​Errors

​Related

Syndication tasks

Toggle syndication

Request

Parameters

Response

Errors

Related