Skip to main content

​
Endpoint

  • Method: POST
  • URL: {{LIQUIDITY_URL}}/v1/ext/linked-accounts/:currency/:linkedAccountId/withdrawal
  • Auth: Bearer {{accessToken}}

​
Path Parameters

ParameterTypeDescriptionRequired
currencystringCurrency code (e.g., USD)Yes
linkedAccountIdstringID of the linked account (from link response)Yes

​
Query Parameters

ParameterTypeDescriptionRequired
walletIdstringSource wallet ID (optional, uses default if omitted)No

​
Request Body

FieldTypeDescriptionRequired
reasonstringDescription/reason for the withdrawalYes
amountnumberAmount to withdraw (decimal)Yes
transactionTypestringTransaction type: PAYOUTYes
routingTypestringRouting type: ACH, WIRE, or INTERNATIONAL_WIREYes
mfaCodestringMFA code if required (optional)No
walletTypestringWallet type (e.g., SPEND) (optional)No

​
Request

curl -X POST "{{LIQUIDITY_URL}}/v1/ext/linked-accounts/USD/{{linkedAccountId}}/withdrawal?walletId={{walletId}}" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Payout to Samuel",
    "amount": 0.12,
    "transactionType": "PAYOUT",
    "routingType": "ACH"
  }'

​
Response (200)

{
  "message": "Payment queued",
  "data": {
    "id": "0040acde-4b8a-4f46-9468-bacd64e70cbf",
    "status": "SUCCESS",
    "fees": "25.00",
    "amount": "2.10"
  }
}

​
Response Fields

FieldTypeDescription
messagestringStatus message
data.idstringTransaction ID for tracking
data.statusstringTransaction status (e.g., SUCCESS, PENDING)
data.feesstringFees charged for the withdrawal
data.amountstringFinal amount after fees

​
Notes

  • Use the appropriate routingType based on the linked account type:
    • ACH for US bank accounts
    • INTERNATIONAL_WIRE for international bank accounts
    • WIRE for domestic wire transfers
  • Works for all linked account option types (bank, card, international_bank, zelle, venmo, paypal, prepaid_card)
  • If walletId is not provided, the system will use the default wallet for the entity