---
title: "GET /v1/global-payout/accounts"
method: GET
path: "/v1/global-payout/accounts"
---

# GET /v1/global-payout/accounts

`GET /v1/global-payout/accounts`

## Request

- Base URL: `https://api.nomba.com`
- URL: `https://api.nomba.com/v1/global-payout/accounts`
- Auth: none declared. Required headers: `Authorization`, `accountId`

Retrieve all of your currency wallets and their balances (e.g. CAD, USD) under your parent accountId. Use this to check a non-NGN balance instead of the NGN-only parent account endpoint.

## Headers

- `Authorization` string, required
- `accountId` string, required

## Response `200`

Accounts retrieved successfully.

- object
  - `code` string
  - `description` string
  - `status` boolean: Legacy envelope flag. Global Payout endpoints leave it false even on success - read code instead, where 00 means success.
  - `data` object[]
    - `accountId` string: The wallet id. Pass this value to GET /v1/global-payout/accounts/{accountId} to fetch this account on its own.
    - `name` string
    - `currency` string
    - `balance` number, nullable: Everything the wallet holds, liens included. Null when the balance could not be read - see status.
    - `availableBalance` number, nullable: The balance less anything held under lien: what can actually be paid out. Null when the balance could not be read - see status.
    - `status` 'ACTIVE' | 'UNAVAILABLE': ACTIVE when the balances are good. UNAVAILABLE means you hold the account but its balance could not be read on this request, and both balance fields are null - the account still exists, so retry rather than treating it as closed.
    - `operationRegion` string

## Changes

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

[Operation history](https://skmtc.dev/nomba/apis/vendor-api/changes/v1/global-payout/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)