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

> Page through advertiser summaries with filtering

`GET /api/v2/buyer/advertisers`

Returns a paginated list of advertiser summary rows. Each row is the compact shape — call [Get advertiser](/v2/buyer/advertisers/tasks/get-advertiser) for the full resource with brand, linked accounts, UTM config, and frequency caps.

## Request

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

## Parameters

| Field                    | Type    | Required | Notes                                                                                                     |
| ------------------------ | ------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `status`                 | enum    | No       | `ACTIVE`, `ARCHIVED`, or `ALL`. Defaults to `ACTIVE`                                                      |
| `name`                   | string  | No       | Case-insensitive partial match on advertiser name                                                         |
| `sandbox`                | boolean | No       | `true` returns only sandbox advertisers, `false` only production. Omit for all                            |
| `linkedAccountPartnerId` | string  | No       | Exact partner / sales-agent ID. Returns only advertisers with a currently linked account for that partner |
| `limit`                  | integer | No       | Max rows per page. Default `100`, max `100`                                                               |
| `offset`                 | integer | No       | Rows to skip for pagination. Default `0`                                                                  |

## Response

```json theme={null}
{
  "items": [
    {
      "id": "12345",
      "name": "Acme Corp",
      "status": "ACTIVE",
      "sandbox": false,
      "brand": "acme.com",
      "primaryCurrency": "USD",
      "linkedAccountCount": 3,
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-20T14:45:00Z"
    }
  ],
  "total": 42,
  "hasMore": false,
  "nextOffset": null
}
```

`linkedAccountCount` replaces the embedded account list on summary rows. When `hasMore` is `true`, pass `nextOffset` as the next `offset`.

## Errors

* `400 VALIDATION_ERROR` — invalid `status` value or out-of-range `limit`.

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="Get advertiser" href="/v2/buyer/advertisers/tasks/get-advertiser" icon="magnifying-glass">
    Fetch the full resource
  </Card>

  <Card title="Create advertiser" href="/v2/buyer/advertisers/tasks/create-advertiser" icon="plus">
    Open a new advertiser
  </Card>
</CardGroup>