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": "",
        "bank": "Testing Bank",
        "bankCode": "000017",
        "currency": "NGN",
        "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": ""
      }
    ],
    "meta": {
      "total": 1
    }
  }
}