---
title: "Get connected accounts"
method: GET
path: "/connected_accounts"
tags: ["Connected Accounts"]
---

# Get connected accounts

`GET /connected_accounts`

## Request

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

Returns all connected accounts.

## Query parameters

- `mainAccounts` boolean
- `pageSize` integer
- `pageCursor` string

## Response `200`

Get accounts response

- ConnectedAccountsResponse
  - `data` ConnectedAccount[], required: List of connected accounts matching the query.
    - `id` string, required: Unique identifier of the connected account.
    - `name` string, required: Human-readable name of the connected account.
    - `providerId` string, required: The ID of the venue the account belongs to.
    - `status` 'WAITING_FOR_APPROVAL' | 'APPROVED' | 'REJECTED' | 'CANCELLED' | 'FAILED', required
    - `totalBalance` ConnectedAccountTotalBalance, required
      - `amount` string, required: The denominated currency value of the account.
      - `denominatedAssetId` string, required: The asset ID of the total balance.
      - `hasFullAssetCoverage` boolean, required: Indicates whether the total amount represents the complete balance of all assets in the account. When true, all asset balances have been successfully converted to the denominated currency. When false, some assets could not be included in the total due to missing exchange rates or non-convertible assets.
    - `manifest` ConnectedAccountManifest, required
      - `assetTypes` ConnectedAccountAssetType[], required: Asset types supported by the connected account.
      - `capabilities` ConnectedAccountCapability[], required: Features supported for the connected account. Logic: - If account capabilities include ramp -> TRADING - If account capabilities include transfers -> DEPOSITS - If account capabilities include transfersBlockchain / transfersFiat / transfersPeerAccounts / transfersInternal -> WITHDRAWALS
    - `parentId` string: The ID of the parent main account, if this is a sub account.
    - `apiKey` string: The API key identifier used to connect this account.
    - `providerAccountName` string: The account name provided by the provider.
    - `accountType` 'EXCHANGE' | 'FIAT' | 'CONNECTED_ACCOUNT', required
  - `total` integer: Total number of accounts by query.
  - `next` string: A cursor for the next page of results, if available.

## Other responses

- `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)