The lookup resource facilitates the retrieval of metadata associated with mobile money or bank accounts. For instance, prior to creating payment accounts, you can utilize this endpoint to validate whether an account number corresponds to a specific business or individual.

This functionality proves especially valuable in ensuring that only validated payment accounts are utilized; for example, when integrated with other processes, such as payouts, it helps mitigate the risk of costly reversals or refunds resulting from funds being sent to an incorrect recipient.

Account not found

While we strive to ensure that our lookup sources are always up to date with the most recent data, we must consider instances when we cannot retrieve metadata for a requested payment account.

In such cases, our API will respond with the error code LOOKUP_ACCOUNT_NOT_FOUND, providing a way to programmatically determine whether the account lookup was unsuccessful.

Lookups reliability varies a lot between countries. If you receive a 500 error, please wait a few minutes and try your request again.

Supported countries/account types

To view the complete list of supported countries and payment accounts, visit the Country support section in the General tab.

Each country page indicates whether lookup functionality is available for that specific country.