v1

latestOpenAPI 3.0.12026-07-2679100267.2 KB

Accounts

Fetch sub account details

You can use this endpoint to get details of a sub account.

get/v1/accounts/sub-account-details

Query parameters

accountIdstring uuid

The id of the sub account whose details is to be fetched

accountRefstring uuid

The unique reference you passed when creating the sub account

Headers

accountIdstring uuid required

Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Response

OK - your request was successful.

codestring required

Response Code

descriptionstring required

Response description

Example response

{
  "code": "00",
  "description": "Success",
  "data": {
    "createdAt": "2023-09-04T07:09:06.900Z",
    "accountId": "fc81b80e-e607-4b86-8591-840925191733",
    "accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
    "bvn": "12234412345",
    "status": "ACTIVE",
    "type": "virtual",
    "accountName": "Daniel Scorsese",
    "currency": "NGN",
    "banks": [
      {
        "bankAccountNumber": "93910",
        "bankName": "Sterling Bank",
        "bankAccountName": "Nomba/Ifeoluwa Adeboye"
      }
    ]
  }
}