Skip to main content
GET
/
connected_accounts
/
{accountId}
/
allowlist
TypeScript
const response: Promise<FireblocksResponse<AllowlistResponse>> = fireblocks.connectedAccountsBeta.getConnectedAccountAllowlist(connectedAccountsBetaApiGetConnectedAccountAllowlistRequest);
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "assets": [
        "BTC",
        "ETH"
      ],
      "networks": [
        "ETHEREUM",
        "POLYGON"
      ],
      "label": "Coinbase Hot Wallet",
      "addressIdentifier": null,
      "status": "ACTIVE",
      "addedAt": "2024-01-15T10:30:00Z",
      "providerReferenceId": "CB-SAMPLE-001"
    }
  ],
  "total": 42,
  "metadata": {
    "lastSyncedAt": "2026-05-01T15:30:00Z",
    "syncStatus": "SUCCESS"
  },
  "next": "eyJsYXN0SWQiOiJlbnRyeS0wMDQifQ=="
}

Path Parameters

accountId
string
required

The connected account identifier

Query Parameters

status
enum<string>

Filter by allowlist entry status 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.
Available options:
ACTIVE,
PENDING_PROVIDER_COOLDOWN,
PENDING_PROVIDER_REVIEW,
PENDING_APPROVAL,
REJECTED,
REMOVED
Example:

"ACTIVE"

assetId
string

Filter by Fireblocks asset ID.

See List assets for the canonical list of Fireblocks asset IDs.

networkId
string

Filter by Fireblocks network ID.

See List blockchains for the canonical list of Fireblocks blockchain identifiers.

address
string

Filter by specific address

pageCursor
string

Pagination cursor for next page

pageSize
integer

Maximum number of entries to return

Required range: 1 <= x <= 1000
sortBy
enum<string>
default:addedAt

Field to sort results by.

Available options:
addedAt,
lastSyncedAt
order
enum<string>
default:DESC

Sort order (ASC or DESC).

Available options:
ASC,
DESC
Example:

"ASC"

Response

Allowlist entries response

data
object[]
required

Array of allowlist entries

Example:
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"assets": ["BTC", "ETH"],
"networks": ["ETHEREUM", "POLYGON"],
"label": "Coinbase Hot Wallet",
"addressIdentifier": null,
"status": "ACTIVE",
"addedAt": "2024-01-15T10:30:00Z",
"providerReferenceId": "CB-SAMPLE-001"
}
]
total
integer
required

Total number of allowlist entries

Example:

42

metadata
object

Allowlist-specific metadata

next
string

Cursor for the next page of results, if available

Example:

"eyJsYXN0SWQiOiJlbnRyeS0wMDQifQ=="