Account Details
Last updated September 16th, 2025
get api.withmono.com/v2/accounts/{id}This resource represents the account details with the financial institution.
Data Statuses and Definitions
available: Both balance and transactions was returned.partial: Either balance or transactions was returned, but not both.unavailable: Balance and transactions were not returned, due to issues from the bank or the user has no data available.failed: Balance and transactions were not returned due to an issue from Mono’s system only (e.g. internal service errors, timeouts e.t.c.).
Please note: This endpoint will consistently include a retrieved_data array in the meta object for all statuses. This gives you visibility into what was actually fetched. Read more
Real-time Data
Real-time account balance is returned when x-real-time in your headers is set to true.
Currency
The currency returned in each country:
NGN KOBO
GHC PESEWA
KSH CENTS
ZAR CENTS
BVN (Nigeria only)
Please note that the last 4 digits of the BVN get returned on this API. To get the full BVN, please call our Identity API to get full BVN information.
Data status
If the meta data_status is still in the processing stage, you have to wait before calling the APIs below e.g Statement, Transaction, Income and Identity Endpoints.
Some banks are faster than others, so it may be available instantly after authorization and some banks might take a few seconds or minutes.
Request
curl --request GET \
--url https://api.withmono.com/v2/accounts/id \
--header 'mono-sec-key: string' \
--header 'accept: application/json'
Response
Choose an option from the drop down or click one of these buttons to see an example:
