---
title: "Get allowlist for connected account"
method: GET
path: "/connected_accounts/{accountId}/allowlist"
tags: ["Connected Accounts"]
---

# Get allowlist for connected account

`GET /connected_accounts/{accountId}/allowlist`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/connected_accounts/{accountId}/allowlist`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/connected_accounts/:accountId/allowlist/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the address allowlist for a specified connected account.

**Note:** Currently supports CoinbaseExchange/Binance accounts only.

## Path parameters

- `accountId` string, required

## Query parameters

- `status` 'ACTIVE' | 'PENDING_PROVIDER_COOLDOWN' | 'PENDING_PROVIDER_REVIEW' | 'PENDING_APPROVAL' | 'REJECTED' | 'REMOVED': Current status of the allowlist entry. - `ACTIVE` — Entry is approved and usable. - `PENDING_PROVIDER_COOLDOWN` — Entry was recently added or modified and is in the provider-enforced cooldown window before becoming active. - `PENDING_PROVIDER_REVIEW` — Entry is awaiting provider-side review. - `PENDING_APPROVAL` — Entry is awaiting customer/admin approval on the Fireblocks side. - `REJECTED` — Entry was rejected at submission time and will not become active. - `REMOVED` — Entry was deactivated after previously being active. May still appear in results for audit purposes.
- `assetId` string
- `networkId` string
- `address` string
- `pageCursor` string
- `pageSize` integer
- `order` 'ASC' | 'DESC'

## Response `200`

Allowlist entries response

- AllowlistResponse
  - `data` AllowlistEntry[], required: Array of allowlist entries
    - `id` string, uuid, required: Unique identifier for the allowlist entry
    - `address` string, required: The blockchain address
    - `assets` string[], required: Assets approved for this address. Each value is either a Fireblocks asset ID (when the provider's asset maps to a Fireblocks-supported asset) or the raw provider asset symbol (when no mapping exists). Treat values as opaque strings. Possible combinations: - One or more specific asset values (e.g., `["BTC", "ETH"]`) See [List assets](https://developers.fireblocks.com/reference/listassets) for the canonical list of Fireblocks asset IDs.
    - `networks` string[], required: Networks approved for this address. Each value is either a Fireblocks network ID (when the provider's network maps to a Fireblocks-supported blockchain) or the raw provider blockchain identifier (when no mapping exists). Treat values as opaque strings. Possible combinations: - One or more specific network values (e.g., `["ETHEREUM", "POLYGON"]`) See [List blockchains](https://developers.fireblocks.com/reference/listblockchains) for the canonical list of Fireblocks blockchain identifiers.
    - `label` string, nullable: Human-readable label for the address
    - `addressIdentifier` string, nullable: Additional identifier (e.g., memo, destination tag)
    - `status` 'ACTIVE' | 'PENDING_PROVIDER_COOLDOWN' | 'PENDING_PROVIDER_REVIEW' | 'PENDING_APPROVAL' | 'REJECTED' | 'REMOVED', required: Current status of the allowlist entry. - `ACTIVE` — Entry is approved and usable. - `PENDING_PROVIDER_COOLDOWN` — Entry was recently added or modified and is in the provider-enforced cooldown window before becoming active. - `PENDING_PROVIDER_REVIEW` — Entry is awaiting provider-side review. - `PENDING_APPROVAL` — Entry is awaiting customer/admin approval on the Fireblocks side. - `REJECTED` — Entry was rejected at submission time and will not become active. - `REMOVED` — Entry was deactivated after previously being active. May still appear in results for audit purposes.
    - `addedAt` string, date-time, required: ISO 8601 timestamp when entry was added
    - `providerReferenceId` string, nullable: Provider's internal reference ID
    - `providerMetadata` AllowlistEntryProviderMetadata, nullable: Provider-specific pass-through data for this address. Treat as an opaque blob: the shape, set of keys, and value types vary by provider, by entry, and over time. Keys may be added, renamed, or removed without notice as providers evolve their integrations or as new providers are added. The example below illustrates one possible shape and is not a contract — do not program against specific keys.
  - `metadata` AllowlistMetadata: Allowlist-specific metadata
    - `lastSyncedAt` string, date-time: ISO 8601 timestamp of last sync with provider
    - `syncStatus` 'SUCCESS' | 'FAILED' | 'IN_PROGRESS' | 'NEVER_SYNCED': Status of last sync operation
  - `total` integer, required: Total number of allowlist entries
  - `next` string: Cursor for the next page of results, if available

## Other responses

- `404`: Connected account not found
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)