Virtual AccountGet Virtual Account

Get Virtual Account

Retrieve comprehensive details about a specific virtual account using its account number.

Endpoint https://api.chapa.co/v1/virtual-account/{accountNumber}

Method GET

  • Authorization: Pass your secret key as a bearer token in the request header to authorize this call.

Path Parameters

ParameterRequiredTypeDescription
accountNumberYesstringThe unique identifier of the virtual account to be retrieved

Response Parameters

ParameterTypeDescription
account_numberstringUnique identifier of the virtual account
account_namestringName associated with the account
account_aliasstringCustom reference name for the account
balancenumberCurrent balance in the account
currencystringCurrency of the account (e.g., ETB)
statusstringCurrent status of the account (e.g., active)
created_atstringTimestamp of account creation
updated_atstringTimestamp of the most recent transaction
import requestsurl = "https://api.chapa.co/v1/virtual-account/100798347"headers = {  'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx'}response = requests.get(url, headers=headers)print(response.text)

ℹ️

Refer to our Error Codes page for all possible responses for this request.