Skip to main content
POST
/
wallets
/
ext
/
debit
/
fiat
Request Bank Account Withdrawal
curl --request POST \
  --url https://api.obiex.finance/v1/wallets/ext/debit/fiat \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "destination": {
    "accountNumber": "",
    "accountName": "",
    "bankName": "",
    "bankCode": ""
  },
  "amount": 1,
  "currency": "string",
  "narration": "string"
}
'
{
  "message": "Ok",
  "data": {
    "id": "0edb705b-9392-49c7-ad16-76bea0f84faf",
    "createdAt": "2026-03-31T15:17:08.555Z",
    "updatedAt": "2026-03-31T15:17:08.555Z",
    "active": true,
    "reference": "bb976d10-d805-456a-9b3e-5a4ec4c9a026",
    "description": "External payout",
    "narration": "first withdrawal",
    "type": "DEBIT",
    "category": "WITHDRAWAL",
    "amount": 15000,
    "walletId": "638ded38-77db-4763-9106-c9923bf5151b",
    "payout": {
      "id": "4c55a831-7909-432a-8db4-5514ff9fac62",
      "createdAt": "2026-03-31T15:17:08.555Z",
      "updatedAt": "2026-03-31T15:17:08.555Z",
      "active": true,
      "transferReference": null,
      "externalReference": null,
      "status": "APPROVED",
      "dollarValue": 8.7,
      "fee": 50,
      "bitcoinValue": 0.00012964,
      "payoutAmount": 15000,
      "payoutCurrency": "NGNX",
      "bankAccount": {
        "id": "52669ecc-b842-4976-9e55-05697d7702d3",
        "createdAt": "2026-03-31T15:17:08.555Z",
        "updatedAt": "2026-03-31T15:17:08.555Z",
        "active": true,
        "accountNumber": "90xxxxxxxxx",
        "accountName": "Jane Doe",
        "bankName": "OPAY",
        "payoutId": "4c55a831-7909-432a-8db4-5514ff9fac62"
      },
      "transactionId": "0edb705b-9392-49c7-ad16-76bea0f84faf"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.obiex.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-api-key
string
header
required

Headers

Body

application/json

The body is of type object.

Response

200 - application/json

Successful response

The response is of type object.