---
title: "List all sub accounts"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List all sub accounts

`GET /v1/accounts`

## Request

- Base URL: `https://api.nomba.com`
- URL: `https://api.nomba.com/v1/accounts`
- Auth: HTTP bearer

You can use this endpoints to fetch all the accounts tied to a business. Accounts are sorted by date, with the most recently-created account appearing first.

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `accountId` string, uuid, required

## Response `200`

OK - your request was successful.

- object
  - `results` object[]: Contains all accounts tied to a specific merchant/business
    - `accountId` string: The id of the account.
    - `accountHolderId` string: The businessId of the parent that houses this account.
    - `accountRef` string: Unique reference used to track an account from an external process. Would be auto-generated if not provided at the point of creation.
    - `phoneNumber` string: The phoneNumber that is unique to the account bearer.
    - `email` string: Email of the account bearer.
    - `bvn` string: Bank verification number of the account bearer.
    - `type` 'virtual' | 'physical': Type of the account.
    - `accountName` string: Name of the account bearer.
    - `banks` object[]: Contains all the bank details tied to a Nomba account
      - `bankAccountNumber` string: The bank account number tied to the Nomba account.
      - `bankName` string: The bank's name.
      - `bankAccountName` string: The name on the account.
    - `address` string: Address of the account bearer.
    - `status` 'active' | 'pnd' | 'fraudulent' | 'suspend': Status of the account.
    - `currency` 'NGN': Primary currency on the account (Only supported at the moment is “NGN”).
    - `description` string: Brief description of the account.
    - `createdAt` string: The date and time this entity was created. This value uses Coordinated Universal Time (UTC) and ISO 8601 format – `YYYY-MM-DDThh:mm:ssZ`.
    - `updatedAt` string: The date and time this entity was updated. This value uses Coordinated Universal Time (UTC) and ISO 8601 format – `YYYY-MM-DDThh:mm:ssZ`.
  - `cursor` string, int32: Value used to scroll to next page. It will be empty if there is no more page to scroll to

## Other responses

- `400`: The request body sent by merchant did not pass the validation checks
- `401`: The access_token provided to access the resource is missing or invalid.
- `403`: The client does not have the permissions to access this resource
- `404`: The record that the client is trying to access does not exist.
- `429`: The client has maxed out the number of calls within a time period on this resource.
- `500`: Downstream system error.

## Changes

- **2026-11-03** `278a25dccfe5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nomba/apis/vendor-api/changes/v1/accounts/get.md)

---

[API](https://skmtc.dev/nomba/apis/vendor-api.md) - [All operations](https://skmtc.dev/nomba/apis/vendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomba/apis/vendor-api/revisions/278a25dccfe5?raw)