Skip to content
Reference
/
/
Withdraw from a fund acco...

Withdraw from a fund account

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Withdraw from a fund account

Security
oauth2ClientCredentials(Required scopes: investments:write)
Path
fundAccountIdstringrequired
Headers
Idempotency-Keystring

Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h.

org_wallet_refstring
business_idstringrequired
Bodyapplication/jsonrequired
amountnumberrequired

Withdrawal amount, native currency

Example:25000
curl -i -X POST \
  'https://developer.boyahq.com/_mock/v2/openapi/investments/accounts/{fundAccountId}/withdraw' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -H 'business_id: string' \
  -H 'org_wallet_ref: string' \
  -d '{
    "amount": 25000
  }'

Responses

Bodyapplication/json
referencestringrequired
Example:"wd_01HXYZ..."
statusstringrequired
Example:"PROCESSING"
Response
{
  "reference": "wd_01HXYZ...",
  "status": "PROCESSING"
}