Initiate closure of a virtual bank account. Supported currencies: GBP, EUR, NGN, USD. Returns 400 if already closed or provider/currency not supported; 404 if not found. Required scope: virtual-account:close.
Authorization
oauth2ClientCredentials virtual-account:closeUse your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
In: header
Scope: virtual-account:close
Path Parameters
Virtual bank account ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl --request POST \ --url 'https://example.com/api/external/virtual-bank-account/string/close' \ --header 'Content-Type: application/json' \ --data '{ "reason": "No longer needed"}'{ "message": "Virtual bank account closure initiated successfully", "account_id": "vba_123456789"}GETGet identification type
Look up the country-specific identification type that a customer must provide as their `tin` value. Each country uses a different identification system (e.g. SSN in the US, BVN in Nigeria, NINO in the UK), and individual vs business customers within the same country may require different types. Call this endpoint before creating or updating a customer to know what field label to show in your UI and what value to collect. Save the collected value as the customer's `tin` field. Required scope: `virtual-account:read`.
GETList all banks
Retrieve all supported banks. Filter by currency or country if desired. Required scope: `bank:read`.