---
title: "Create settlement"
method: POST
path: "/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/settlement"
tags: ["Settlements"]
---

# Create settlement

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

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/settlement`
- Auth: none declared. Required headers: `user-id`, `user-agent`, `x-forwarded-for`, `token-scope`, `authorization`

Create a settlement request to send to your counterparty.

Use only with delivery versus payment (DVP) settlements.

**Requires access token scope:** `wallet_spend_all`

## Path parameters

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

## Headers

- `user-id` string, required
- `user-agent` string, required
- `x-forwarded-for` string, required
- `token-scope` string, required
- `origin` string
- `authorization` string, required

## Request body

- object
  - `externalId` string, required
  - `expireAt` string, date-time
  - `notation` string
  - `addressBookConnectionId` string, required
  - `addressBookConnectionUpdatedAt` string, date-time, required
  - `assetTransfers` object[], required
    - `currency` string, required
    - `quantity` string, number, required
  - `bypassCounterpartySigning` boolean
  - `transactionRouteId` string
  - `checkForDuplicates` boolean: HTTP specific codec for create multi-currency settlement

## 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
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `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/949c62f4ece3?raw)