---
title: "List partner balances"
method: GET
path: "/api/network/v1/enterprises/{enterpriseId}/partners/balances"
tags: ["Partner Balances"]
---

# List partner balances

`GET /api/network/v1/enterprises/{enterpriseId}/partners/balances`

Lists all your OES balances. For use only by OES partners.

Error scenarios:
- 400: Invalid Request Error
- Occurs when the request parameters are invalid or malformed
- Examples: Invalid UUID format for enterpriseId, invalid filter parameters,
invalid pagination parameters

- 401: Authentication Error
- Occurs when the request is not authorized
- Examples: Caller is not a member of the enterprise.

- 403: Permission Denied Error
- Occurs when the authenticated partner doesn't have necessary permissions
- Examples: Partner doesn't have permission to view balances. Enterprise does not have OES license.

- 404: Not Found Error
- Occurs when the specified enterprise cannot be found
- Examples: Enterprise ID doesn't exist or doesn't belong to the partner

- 500: Internal Server Error
- Occurs when there's an unexpected server error processing the request
- Examples: Database connection issues, transient network errors.

**Requires access token scope:** `settlement_network_read`

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `pageNumber` string, integer
- `pageSize` string
- `partnerIds` string[]
- `clientIds` string[]
- `connectionIds` string[]
- `partnersConnectionIds` string[]

## Response `200`

OK

- V1PartnerBalancesGetPayload
  - `networkBalances` V1PartnerNetworkAccountBalanceRecordOutput, required — A record of network account balances for a partner, indexed by connection ID. Each key in this record is a connection ID, and the corresponding value contains details about the connection and its balances across different currencies.
  - `balances` V1PartnerAccountBalanceRecordOutput — A record of account balances for a partner, indexed by the partner's currency codes. Each key in this record is a currency identifier in the partner's naming convention, and the corresponding value contains the available and held amounts for that currency. Note that currency codes here may differ from BitGo's internal currency codes, as they are mapped to match the partner's expected currency identifiers.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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)