API Explorer
Account Services
Account Inquiry - All Accounts

Account Inquiry - All Accounts

Description

Allow merchants to validate Equity bank accounts.

Test URL

GEThttps://uat.finserve.africa/v3-apis/account-api/v3.0/account/validate

Live URL

GEThttps://api.finserve.africa/v3-apis/account-api/v3.0/account/validate

Get account details

Example Request

Signature Formulae e.g. KE00201XXXX14605JOHNDOE
countryCode+accountNumber+accountFullName
Example Request
curl -X GET \
	-H 'Authorization: Bearer {access_token}'  \
	-H 'signature: e967CLKebZyLfa73/YYltjW5M4cHoyWeHi/5VDKJ64gOwKBvzHJRqJJrBBc34v2m4jyKkDMBtfRJeFlxbNisMAeBtkw0TRcD2LThFK27EOqLM3m8rQYa+7CJ2FhPhK+iOa4RUY+vTfkRX5JXuqOW7a3GHds8qyPaPe19cKUY33eAJL3upXnGnA3/PEhzjhb0pqk2zCI7aRzvjjVUGwUdT6LO73NVhDSWvGpLEsP0dH/stC5BoTPNNt9nY8yvGUPV7fmaPSIFn68W4L04WgePQdYkmD1UPApGcrl+L2ALY3lPaRfI6/N+0Y3NIWQyLgix+69k7V4EGolqejWdion+9A=='  \
	-L 'https://uat.finserve.africa/v3-apis/account-api/v3.0/account/validate'

Example Response

Example Response
{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "account": {
            "fullNames": "BMCE SERVICES LTD",
            "currency": "UGX",
            "accountNumber": "1036*****9994",
            "status": "Active"
        }
    }
}

Response Codes

Http Response CodeResponse CodeDescription
2000Request Processed Successfully
104101Request successful;Account validation failed
400900100Invalid Signature
401401, 401101Unauthorized access
401101API Access restricted to Logged-in user
403403Forbidden
500500Internal Server Error
Account InquiryWithin Equity Bank