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

> List cached Google Ad Manager advertiser records for an ESA

`GET /api/v2/storefront/esa/{esaId}/gam/advertisers`

Lists the Google Ad Manager advertiser records cached from the network behind a GAM-backed embedded sales agent. Use it to find the `id` you pass when setting the default advertiser or a buyer-specific mapping target. Results are cursor-paginated; filter by name or numeric id with `q`.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.interchange.io/api/v2/storefront/esa/123/gam/advertisers?q=acme&limit=50" \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

| Field    | Type    | Required | Notes                                                           |
| -------- | ------- | -------- | --------------------------------------------------------------- |
| `esaId`  | integer | Yes      | Path. Embedded sales-agent connection id                        |
| `q`      | string  | No       | Query. Advertiser name substring or exact numeric advertiser id |
| `query`  | string  | No       | Query. Alias for `q`                                            |
| `limit`  | integer | No       | Query. Page size, max 500                                       |
| `cursor` | string  | No       | Query. Pagination cursor from a prior `nextCursor`              |

## Response

```json theme={null}
{
  "advertisers": [
    {
      "id": "4567890123",
      "name": "Acme Beverages",
      "status": "ACTIVE",
      "currencyCode": "USD"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ",
  "syncedAt": "2026-06-01T09:30:00.000Z"
}
```

`advertisers[].id` is the GAM advertiser id you pass as `gamAdvertiserId`. `nextCursor` is `null` on the last page. `syncedAt` is when the cache was last refreshed from the network, or `null` if it has never synced. `currencyCode` may be `null`.

## Errors

* `400 VALIDATION_ERROR` — `esaId` is not a positive integer, or the ESA is not Google Ad Manager-backed.

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

## Related

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

  <Card title="Buyer routing overview" href="/v2/storefront/buyer-routing/overview" icon="route">
    How buyers resolve to advertisers
  </Card>

  <Card title="Ensure GAM advertiser" href="/v2/storefront/buyer-routing/tasks/ensure-gam-advertiser" icon="plus">
    Create or find an advertiser by name
  </Card>

  <Card title="Set default advertiser" href="/v2/storefront/buyer-routing/tasks/set-default-advertiser" icon="star">
    Pick the catch-all advertiser
  </Card>
</CardGroup>