> ## 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 available accounts

> Discover partner accounts available to link to an advertiser

`GET /api/v2/buyer/advertisers/{advertiserId}/accounts/available`

Lists accounts a source has discovered but not yet linked to the advertiser. Call this before linking an account to pre-fill `accountId` and check the source's supported `billingOptions`.

<Warning>
  This advertiser-scoped operation is the legacy AdCP account flow. Although
  compatibility mirroring may expose official-adapter accounts here, it is not
  the authoritative workflow for Meta, Google Ads, TikTok, Snap, or other
  official adapters, and an empty result does not describe their connection. Use
  `list_storefront_connections`, `list_storefront_connection_accounts`, and
  `list_storefront_connection_account_mappings` for those platforms. See
  [Ad Platform Accounts](/v2/concepts/ad-platform-accounts).
</Warning>

## Request

```bash curl theme={null}
curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/accounts/available?storefrontId=42&sourceId=src_main&take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field          | Type            | Required | Notes                                                                                          |
| -------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------- |
| `advertiserId` | string (path)   | Yes      | Unique identifier for the advertiser                                                           |
| `storefrontId` | integer (query) | Yes      | Storefront the source lives on                                                                 |
| `sourceId`     | string (query)  | Yes      | Inventory source within `storefrontId`                                                         |
| `refresh`      | enum (query)    | No       | `true` re-fetches from the source; `false` (default) returns cached accounts                   |
| `billingType`  | string (query)  | No       | Filter by billing type. Must be a value the source supports. Defaults to the source's default  |
| `credentialId` | string (query)  | No       | Specific registered credential to use. Required when multiple credentials exist for the source |
| `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}
{
  "accounts": [
    {
      "accountId": "acc_acme_pinnacle",
      "credentialId": "cred_snap_coke",
      "name": "Acme c/o Pinnacle",
      "advertiser": "Acme Corp",
      "billingProxy": "Pinnacle Media",
      "house": "acme-corp.com",
      "billing": "advertiser",
      "sources": [
        { "storefrontId": 42, "storefrontName": "Example Storefront", "sourceId": "src_main", "sourceName": "Main Source" }
      ],
      "status": "active"
    }
  ],
  "total": 8,
  "synced": false,
  "billingOptions": { "default": "advertiser", "supported": ["advertiser", "agent"] }
}
```

`account.status` is one of `active`, `pending_approval`, `payment_required`, `suspended`, `closed`. `credentialId` identifies the connected provider credential that owns the account. Include it when linking the account if the buyer has connected more than one credential for the same adapter storefront and duplicate account IDs may exist. `synced` is `true` when no accounts matched and a `sync_accounts` call was triggered to provision one at the partner. Always check `billingOptions.supported` before sending a `billingType`.

## Errors

* `400 VALIDATION_ERROR` — missing `storefrontId`/`sourceId`, or multiple credentials exist and `credentialId` was not provided.
* `404 NOT_FOUND` — `advertiserId` or source does not exist or is not visible.

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#linked-accounts" icon="user-tie">
    Linked accounts model
  </Card>

  <Card title="Create advertiser" href="/v2/buyer/advertisers/tasks/create-advertiser" icon="plus">
    Link accounts at creation
  </Card>

  <Card title="Update reporting bucket" href="/v2/buyer/advertisers/tasks/update-account-reporting-bucket" icon="bucket">
    Configure offline delivery on a link
  </Card>

  <Card title="Ad platform accounts" href="/v2/concepts/ad-platform-accounts" icon="sitemap">
    Connect, discover, and map official adapter accounts
  </Card>
</CardGroup>