---
title: "Get settlement by ID"
method: GET
path: "/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/settlement/{settlementId}"
tags: ["Settlements"]
---

# Get settlement by ID

`GET /api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/settlement/{settlementId}`

Get a settlement by its settlement ID.

Use only with delivery versus payment (DVP) settlements.

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

## Path parameters

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

## Response `200`

OK

- SettlementResponse
  - `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

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