GET
/
accounts
{
  "status": "00",
  "message": "The process was completed successfully",
  "data": {
    "accounts": [
      {
        "account_number": "0123456789",
        "customer_id": "1234567890",
        "account_name": "Ado John Sule",
        "currency_code": "NGN",
        "account_opening_date": "2017-01-13",
        "last_transaction_time": "2019-03-15T07:05:59.524Z",
        "account_type": "Wonderful Savings Account",
        "bvn": "2214224567",
        "phone_number": "09091234567",
        "email": "ado.john@example.com",
        "status": "ACTIVE",
        "custom_properties": [
          {
            "id": "1",
            "description": "custom_property",
            "type": "string",
            "value": "custom_property"
          }
        ]
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
connection-id
string

Connection ID for the target bank

​
idempotency-key
string
required

Unique key to ensure idempotency of the request

​
signature
string
required

SHA-256 signature of client_secret + ";" + idempotency-key

Response

Account details retrieved successfully

​
status
string
Example:

"00"

​
message
string
Example:

"The process was completed successfully"

​
data
object
⌘I