> ## 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.

# List audiences

> See synced audience metadata for an advertiser

`GET /api/v2/buyer/advertisers/{advertiserId}/audiences`

Lists stored audience metadata for an advertiser. Each row is a summary — match status, uploaded count, and matched count — for audiences synced via [Sync audiences](/v2/buyer/advertisers/tasks/sync-audiences).

## Request

```bash curl theme={null}
curl "https://api.interchange.io/api/v2/buyer/advertisers/25/audiences?take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field          | Type            | Required | Notes                                       |
| -------------- | --------------- | -------- | ------------------------------------------- |
| `advertiserId` | string (path)   | Yes      | Advertiser ID (numeric string, e.g. `25`)   |
| `take`         | integer (query) | No       | Results to return. Default `50`, max `250`  |
| `skip`         | integer (query) | No       | Results to skip for pagination. Default `0` |

## Response

```json theme={null}
{
  "audiences": [
    {
      "audienceId": "loyalty-members-2026",
      "name": "Loyalty members",
      "accountId": "25",
      "status": "READY",
      "deleted": false,
      "uploadedCount": 48210,
      "matchedCount": 41003,
      "createdAt": "2026-06-01T09:00:00Z",
      "updatedAt": "2026-06-06T09:00:00Z"
    }
  ],
  "total": 1
}
```

`status` is `PROCESSING`, `ERROR`, `READY`, or `TOO_SMALL`. `uploadedCount` and `matchedCount` are `null` until processing completes. Pagination metadata (`take`, `skip`, `hasMore`) is in `meta.pagination` — see [Pagination](/v2/reference/pagination).

## Errors

* `404 NOT_FOUND` — `advertiserId` does not exist or is not visible to the authenticated account.

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

## Related

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

  <Card title="Advertiser overview" href="/v2/object-guides/advertiser" icon="user-tie">
    Fields, lifecycle, and concepts
  </Card>

  <Card title="Sync audiences" href="/v2/buyer/advertisers/tasks/sync-audiences" icon="users-gear">
    Add or update audience members
  </Card>
</CardGroup>