---
title: "List settlement trading partners (counterparties)"
method: GET
path: "/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/trading-partners"
tags: ["Settlement Onboarding"]
---

# List settlement trading partners (counterparties)

`GET /api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/trading-partners`

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/trading-partners`
- Auth: none declared. Required headers: `user-id`

List settlement trading partners (counterparties) for a given Go Account.

Use only with delivery versus payment (DVP) settlements.

**Requires access token scope:** `wallet_view_all`

## Path parameters

- `enterpriseId` string, required
- `accountId` string, required

## Query parameters

- `status` union
  - 'accepted' | 'rejected' | 'canceled'
  - 'pending'

## Headers

- `user-id` string, required

## Response `200`

OK

- TradingPartnerListResponse
  - `tradingPartnerList` object[], required
    - `id` string, required
    - `primaryAccountId` string, required
    - `primaryEnterpriseName` string, required
    - `secondaryAccountId` string, required
    - `secondaryEnterpriseName` string, required
    - `status` union, required
      - 'accepted' | 'rejected' | 'canceled'
      - 'pending'
    - `addressBookConnectionId` string
    - `addressBookConnectionUpdatedAt` string, date-time
    - `updatedAt` string, date-time, required

## Other responses

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

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) - [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/6b6e050a7f84?raw)