Skip to main content
POST
/
orders
/
{id}
/
cancel
Cancel a pending order
curl --request POST \
  --url https://api.conduit.financial/v2/orders/{id}/cancel \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "customerId": "<string>",
  "source": {
    "type": "wallet",
    "id": "<string>"
  },
  "destination": {
    "type": "wallet",
    "id": "<string>"
  },
  "sourceAsset": {
    "code": "USDC",
    "chain": "ethereum",
    "amount": "100"
  },
  "destinationAsset": {
    "code": "USDC",
    "chain": "ethereum",
    "amount": "100"
  },
  "rate": {
    "referenceRate": "<string>",
    "totalSpreadBps": "<string>",
    "endUserRate": "<string>"
  },
  "fees": [
    {
      "code": "FIXED_FEE",
      "type": "fixed",
      "assetAmount": {
        "code": "USDC",
        "chain": "ethereum",
        "amount": "100"
      }
    }
  ],
  "totalDebit": {
    "code": "USDC",
    "chain": "ethereum",
    "amount": "100"
  },
  "lockExpiresAt": "2026-01-15T09:30:00.000Z",
  "createdAt": "2026-01-15T09:30:00.000Z",
  "autoExecute": true,
  "linkedTransactionIds": [
    "<string>"
  ],
  "clientReferenceId": "<string>",
  "autoPayout": {
    "recipient": {
      "rail": "us",
      "accountNumber": "<string>",
      "routingNumber": "<string>",
      "bankAddress": {
        "addressLine1": "<string>",
        "city": "<string>",
        "country": "<string>",
        "addressLine2": "<string>",
        "state": "<string>",
        "postalCode": "<string>"
      },
      "phone": "<string>",
      "type": "INDIVIDUAL",
      "firstName": "<string>",
      "lastName": "<string>",
      "postalAddress": {
        "addressLine1": "<string>",
        "city": "<string>",
        "country": "<string>",
        "addressLine2": "<string>",
        "state": "<string>",
        "postalCode": "<string>"
      },
      "bankName": "<string>",
      "dateOfBirth": "2023-12-25",
      "countryOfCitizenship": "<string>"
    },
    "ach": {},
    "swift": {
      "purposeOfPayment": "<string>"
    },
    "instant": {},
    "remittance": {
      "reference": "<string>",
      "description": "<string>"
    }
  },
  "executedAt": "2026-01-15T09:30:00.000Z",
  "cancelledAt": "2026-01-15T09:30:00.000Z",
  "failureMessage": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Headers

​
Idempotency-Key
string
required

Caller-generated unique key that lets the server safely replay this request. The cached response is returned for 5 minutes on any retry with the same key from the same API principal. Required on every state-changing money-moving or resource-creating POST.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_.:-]{1,128}$

Path Parameters

​
id
string
required

Response

​
id
string
required
Pattern: ^ord_[0-9A-Za-z]{22}$
​
customerId
string | null
required
Pattern: ^cus_[0-9A-Za-z]{22}$
​
status
enum<string>
required
Available options:
pending,
succeeded,
failed,
cancelled
​
type
enum<string>
required
Available options:
onramp,
offramp
​
source
object
required
​
destination
object
required
​
sourceAsset
object
required
Example:
{
  "code": "USDC",
  "chain": "ethereum",
  "amount": "100"
}
​
destinationAsset
object
required
Example:
{
  "code": "USDC",
  "chain": "ethereum",
  "amount": "100"
}
​
lockSide
enum<string>
required
Available options:
source,
destination
​
rate
object
required
​
fees
object[]
required
​
totalDebit
object
required
Example:
{
  "code": "USDC",
  "chain": "ethereum",
  "amount": "100"
}
​
lockExpiresAt
string<date-time>
required

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
createdAt
string<date-time>
required

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
autoExecute
boolean
required
​
linkedTransactionIds
string[]
required
Pattern: ^txn_[0-9A-Za-z]{22}$
​
clientReferenceId
string
Pattern: ^[A-Za-z0-9_\-:.]{1,255}$
​
autoPayout
object

AutoPayout payload. Crypto recipients omit rail/ach/swift/instant/remittance; fiat (us|swift) recipients require rail and may carry the matching per-rail context block.

​
executedAt
string<date-time>

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
executionTrigger
enum<string>
Available options:
client,
auto
​
cancelledAt
string<date-time>

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
cancellationReason
enum<string>
Available options:
expired,
client_cancelled
​
failureCode
enum<string>
Available options:
INSUFFICIENT_FUNDS,
PROVIDER_UNAVAILABLE,
PROVIDER_REJECTED,
INTERNAL_ERROR,
CANCELLED
​
failureMessage
string