---
title: "List settlements by enterprise"
method: GET
path: "/api/clearing/v1/enterprise/{enterpriseId}/settlements"
tags: ["Settlements"]
---

# List settlements by enterprise

`GET /api/clearing/v1/enterprise/{enterpriseId}/settlements`

List all settlements for a given enterprise.

Use only with delivery versus payment (DVP) settlements.

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

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `limit` union, required
  - string
  - 50
- `offset` union, required
  - string
  - 0
- `status` union
  - 'canceled' | 'pending' | 'rejected' | 'settled' | 'expired' | 'pending-acknowledgement'
  - string[]
- `counterpartyAccountIds` string[]
- `dateInitiatedOnOrAfter` string, date-time
- `dateInitiatedBefore` string, date-time
- `omitRequesterAccountName` boolean
- `requiresSigning` boolean
- `types` string[]
- `batchId` string[]
- `externalIds` string[]
- `externalIdPrefix` string
- `includeTotalCount` boolean

## Response `200`

OK

- SettlementListResponse
  - `settlementList` object[], required
    - `id` string, required
    - `externalId` string, required
    - `expireAt` string, date-time
    - `notation` string
    - `requesterAccountId` string, required
    - `status` 'canceled' | 'pending' | 'rejected' | 'settled' | 'expired' | 'pending-acknowledgement', required
    - `type` 'direct' | 'agency' | 'disbursement', required
    - `bypassCounterpartySigning` boolean
    - `routedTransactionId` string
    - `clearingMethod` 'manual' | 'manual-netting' | 'automated-netting'
    - `approvalRequests` object[], required
      - `id` string, required
      - `accountId` string, required
      - `status` 'acknowledged' | 'canceled' | 'rejected' | 'approved' | 'pending' | 'failed' | 'overdue' | 'expired' | 'initialized' | 'signed' | 'signing' | 'pending-acknowledgement', required
      - `payload` string, required
      - `signature` string
      - `policyDetailId` string
      - `policyDetail` object
        - `id` string, required
        - `resolutionTime` string, date-time, required
        - `resolvedBy` string[], required
      - `signedAt` string, date-time
      - `signedBy` string
      - `approvedAt` string, date-time
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `settlementTransfers` object[], required
      - `id` string, required
      - `sourceTradingAccountId` string, required
      - `destinationTradingAccountId` string, required
      - `currency` string, required
      - `quantity` string, required
      - `txIds` string[]
      - `estimatedFeeInNativeToken` string
      - `estimatedFeeInUSD` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `requesterAccountName` string
    - `finalizedAt` string, date-time
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `unlockDate` string
  - `totalCount` number

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