---
title: "POST /settlements/{settlement_id}/cancel"
method: POST
path: "/settlements/{settlement_id}/cancel"
tags: ["Settlements"]
---

# POST /settlements/{settlement_id}/cancel

`POST /settlements/{settlement_id}/cancel`

Cancel a settlement by id.
Only Settlement with an outbound transaction in status `FAILED_TO_BROADCAST`
or `SIGNED` can be canceled.
Only Exchange (Liquidity Provider) user can cancel a settlement.

## Path parameters

- `settlement_id` integer, required

## Response `200`

settlement object

- Settlement
  - `from_pledge_id` string, uuid, required
  - `id` string, uuid, required
  - `inbound_transaction_intent` InboundTransactionIntent
    - `amount` integer, required
    - `to_account_id` integer, required
    - `to_address` string, required
  - `meta` object, required
  - `outbound_transaction` OutboundTransaction
    - `request_id` integer, required
    - `transaction_hash` string, nullable
    - `transaction_id` integer, required
  - `repledge` RepledgeRequest
    - `repledge_id` integer, required
    - `request_id` integer, required
  - `repledge_intent` RepledgeIntent
    - `account_name` string, required
    - `amount` string, required
    - `contract_address` string, nullable
    - `currency` string, required
    - `exchange_name` string, required
    - `pledge_subaccount_id` integer, required
    - `to_address` string, nullable
    - `transaction_hash` string, nullable
  - `state` string, required

## Other responses

- `400` — Settlement cannot be canceled
- `404` — Settlement not found

---

[API](https://skmtc.net/ledgerhq/apis/vault-api.md) · [All operations](https://skmtc.net/ledgerhq/apis/vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ledgerhq/vault-api/revisions/c88faa17bc25/schema)