---
title: "Get permitted accounts balances for an enterprise"
method: GET
path: "/api/link/v1/enterprises/{enterpriseId}/balances"
tags: ["Link Accounts"]
---

# Get permitted accounts balances for an enterprise

`GET /api/link/v1/enterprises/{enterpriseId}/balances`

Returns the latest balance snapshots per asset for permitted accounts. When optional query
param `accountIds` is provided, returns balances only for those account IDs; when omitted,
returns all permitted accounts in the enterprise. Optional `venue` restricts accounts by
`venueId`; optional repeated `genericAsset` restricts balance rows to those `genericAsset` values.
Each account includes its permitted sub-account balances. Returns an empty array if no
accounts are found.

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `accountIds` string[]
- `venue` string
- `genericAsset` string[]
- `displayAsset` string[]
- `searchLabel` string
- `limit` union, required
  - string
  - 50
- `offset` union, required
  - string
  - 0

## Headers

- `user-id` string, required

## Response `200`

OK

- V1GetEnterpriseAccountsBalancesResponse — Top-level response for GET enterprise accounts balances
  - `accounts` object[], required
    - `id` string, required
    - `venueId` string, required
    - `status` 'active' | 'inactive' | 'deleted' | 'pending_credentials', required
    - `name` string, required
    - `accountSubTypes` object[], required
      - `balances` object[], required
        - `rawAsset` string, required
        - `genericAsset` string
        - `displayAsset` string, required
        - `asset` string
        - `network` string
        - `available` string, required
        - `locked` string, required
        - `total` string, required
        - `asOfDate` string, date-time, required
      - `accountSubType` string, required — Normalized sub-account-type identifier (e.g. `SPOT`, `MARGIN`, `UNIFIED`).
      - `rawAccountSubType` string — Venue-raw sub-type label for the matching normalized sub-type. Absent for pass-through values.
      - `accountSubTypeLabel` string — Human-readable sub-type display label. Absent when the venue has only one sub-type, or for pass-through values.
    - `subAccounts` object[], required
      - `id` string, required
      - `status` 'active' | 'inactive' | 'deleted' | 'pending_credentials', required
      - `name` string, required
      - `accountSubTypes` object[], required
        - `balances` object[], required
          - `rawAsset` string, required
          - `genericAsset` string
          - `displayAsset` string, required
          - `asset` string
          - `network` string
          - `available` string, required
          - `locked` string, required
          - `total` string, required
          - `asOfDate` string, date-time, required
        - `accountSubType` string, required — Normalized sub-account-type identifier (e.g. `SPOT`, `MARGIN`, `UNIFIED`).
        - `rawAccountSubType` string — Venue-raw sub-type label for the matching normalized sub-type. Absent for pass-through values.
        - `accountSubTypeLabel` string — Human-readable sub-type display label. Absent when the venue has only one sub-type, or for pass-through values.
  - `total` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)