​
List Bank Accounts

This Endpoint retrieves a list of all the user’s bank accounts associated with the logged-in user.

​
Endpoints

{{baseurl}}/accounts

This is a GET request, and it should include the following parameters:

FieldData TypeDescription
customerIdstringRequired. Unique identifier of the customer account you want to retrieve.
referencestringRequired. Unique reference code to identify a bank account.

This is how your request should look:

{
    "customerId": "string",
    "reference": "string"
}

If your request is successful, the response will look like this:

{
    "success": true,
    "statusCode": 200,
    "message": "Fetched list of bank accounts",
    "data": {
        "payload": [
            {
                "id": "d88343f6-f1c2-4e04-8762-39c7add0c1f8",
                "name": "Shiga Technologies LTD / test testing",
                "number": "1185510924",
                "bank": "Testing Bank",
                "bankCode": "000017",
                "currency": "NGN",
                "currencyType": "NGN",
                "iban": "NG12345678901234567890",
                "sortCode": "12-34-56",
                "checkNumber": "123456",
                "bankSwiftCode": "TESTNG33XXX",
                "addressableIn": "Nigeria",
                "bankAddress": "123 Testing Bank Street, Lagos, Nigeria",
                "countryCode": "NG",
                "isVirtual": true,
                "createdAt": "2024-05-01T22:37:54.322Z",
                "updatedAt": "2024-05-01T22:37:54.322Z",
                "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
                "reference": "shsi29wns02j9whdhnw012bd9dh2w",
                "customerId": "326a18a1-441a-457d-ba28-0538e0717c92"
            }
        ],
        "meta": {
            "total": 1
        }
    }
}
Fetch bank accountAirtime services