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
| Parameter | Required | Type | Description |
|---|---|---|---|
| accountNumber | Yes | string | The unique identifier of the virtual account to be retrieved |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| account_number | string | Unique identifier of the virtual account |
| account_name | string | Name associated with the account |
| account_alias | string | Custom reference name for the account |
| balance | number | Current balance in the account |
| currency | string | Currency of the account (e.g., ETB) |
| status | string | Current status of the account (e.g., active) |
| created_at | string | Timestamp of account creation |
| updated_at | string | Timestamp of the most recent transaction |
1import requests23url = "https://api.chapa.co/v1/virtual-account/100798347"45headers = {6 'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx'7}89response = requests.get(url, headers=headers)10print(response.text)ℹ️
Refer to our Error Codes page for all possible responses for this request.