> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/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.apostra.com/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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.