Skip to main content
POST
Abandon a reverse swap

Authorizations

X-Swap-Auth
string
header
required

Per-swap credential returned as swapAuth when the swap is created. Required on the routes that decide a live swap's outcome (re-quotes, cooperative refunds), so knowing the swap ID is not enough.

Path Parameters

id
string
required

Swap id (ULID).

Response

Hold invoice cancelled after confirmed maker recovery, or an unfunded swap expires.

GET /v2/swap/{id} response.

events
object[]
required
id
string
required
paymentStatus
string
required

Customer-funding status, independent from the swap lifecycle.

status
string
required
type
string
required

Swap kind: submarine / reverse / chain.

failureDetails
string | null
failureReason
string | null
payout
object | null

Present on pay-through swaps only.