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

# GET /v1/global-payout/accounts/{accountId}

`GET /v1/global-payout/accounts/{accountId}`

## Request

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

Retrieve the details and balance of a single Global Payout account by its account ID.

## Path parameters

- `accountId` string, required

## Headers

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

## Response `200`

Account 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

## Other responses

- `404`: No account with that id belongs to the authenticated business. Returned when the id is not one of your wallets - including when a currency code such as CAD is sent instead of a wallet id. It is not returned when the balance simply could not be read: that case comes back 200 with status UNAVAILABLE.

## Changes

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

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