> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get syndication status

> Query syndication status records for an advertiser

`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](/v2/buyer/syndication/tasks/syndicate) has reached `COMPLETED`, or to read the `errorMessage` on a `FAILED` record.

## Request

```bash theme={null}
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

| 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

```json theme={null}
{
  "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`.

## Errors

* `400 VALIDATION_ERROR` — unknown `resourceType` or `status`, `limit` outside `1`–`100`, or a missing `advertiserId`.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Syndication tasks" href="/v2/buyer/syndication/tasks" icon="list-check">
    All syndication operations
  </Card>

  <Card title="Toggle syndication" href="/v2/buyer/syndication/tasks/syndicate" icon="toggle-on">
    Turn syndication on or off
  </Card>
</CardGroup>