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

# POST /settlements/{settlement_id}/recover

`POST /settlements/{settlement_id}/recover`

Used to accelerate on-chain confirmation of an Outbound Settlement transaction stuck pending in a mempool. This is only applicable to a settlement with an outbound transaction in status `SUBMITTED`. Only Exchange (Liquidity Provider) operators can recover a settlement and is only applicable to currencies supporting Replace by Fees (RBF) or Replace by Nonce (RBN).

## Path parameters

- `settlement_id` integer, required

## Request body

- SettlementRecoveryData
  - `fee_strategy` union, required — The new fee strategy to apply on the outbound transaction
    - BitcoinFeesStrategy
      - `data` BitcoinFeesStrategyData, required
        - `fees_per_byte` string, required — The fees per byte for the transaction, in the smallest currency unit..
      - `type` 'CUSTOM', required — Indicates a custom fee strategy for Bitcoin transactions.
    - EthereumFeesStrategy
      - `data` union, required — Data specific to the Ethereum fee strategy.
        - EthereumFeesStrategyData
          - `gas_limit` string, required — The gas limit for the Ethereum transaction, in the smallest currency unit.
          - `gas_price` string, required — The gas price for the Ethereum transaction, in the smallest currency unit.
        - EthereumEIP1559FeesStrategyData
          - `gas_limit` string, required — The gas limit for the Ethereum transaction, in the smallest currency unit.
          - `priority_fees` string, required — The maximum priority fee per gas for the Ethereum transaction, in the smallest currency unit.
      - `type` 'CUSTOM', required — Indicates a custom fee strategy for Ethereum transactions.
    - GenericFeesStrategy
      - `data` GenericFeesStrategyData, required
        - `speed` 'FAST' | 'NORMAL' | 'SLOW', required — The desired speed of the transaction.
      - `type` 'SPEED', required — The type of fee strategy based on transaction speed.
  - `max_fee` string, required — The new max fee to apply on the outbound transaction

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