---
title: "List Partners"
method: GET
path: "/api/network/v1/enterprises/{enterpriseId}/partners"
tags: ["Client Activation"]
---

# List Partners

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

Lists all OES Partners associated with the specified enterprise.
Returns a collection of partners with information required to connect to them.

Error scenarios:
- 400: Invalid Request Error
- Occurs when the request parameters are invalid or incomplete.
- Examples: Empty string supplied for enterpriseId.

- 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 access to create a partner.
- Examples: Enterprise does not have OES license.

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

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

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `pageNumber` string, integer
- `pageSize` string
- `ids` string[]
- `names` string[]
- `institutionIds` string[]
- `institutionIdentifiers` string[]
- `active` boolean
- `filterByTrustOrg` boolean
- `allocationPoliciesEnabled` boolean

## Response `200`

OK

- V1PartnersGetOkPayload
  - `partners` object[], required
    - `id` string, required — Unique identifier for the partner.
    - `name` string, required — Display name of the partner.
    - `institutionId` string — Optional identifier linking the partner to an institution in external systems.
    - `institutionIdentifier` string, required — Optional string identifier for the institution.
    - `connectionKeySchema` 'token' | 'tokenAndSignature' | 'apiKeyAndSecret' | 'clearloop', required
    - `active` boolean, required — Boolean flag indicating whether the partner is currently active in the system.
    - `settlementTransactionRouteId` string — Optional identifier for the settlement transaction route associated with this partner.
    - `publicKey` string — Optional RSA public key used for secure communication with the partner.
    - `enterpriseId` string — Enterprise ID associated with this partner, if any.
    - `clientDisputeWindowMinutes` number — Time window in minutes during which clients can dispute transactions.
    - `topUpWindowMinutes` number — Time window in minutes after which dispute window ends for processing top-up operations.
    - `trustOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1', required
    - `stablePartner` boolean, required — Flag indicating whether the partner has demonstrated operational stability. Used when partner is initially launched to demonstrate that the partner is still in beta and not yet stable.
    - `isLicensedForPartner` boolean, 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)