> ## Documentation Index
> Fetch the complete documentation index at: https://developer.nomba.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch accounts

> 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.



## OpenAPI

````yaml get /v1/global-payout/accounts
openapi: 3.0.1
info:
  description: ''
  title: Vendor API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.nomba.com
  - description: Sandbox
    url: https://sandbox.nomba.com
security: []
tags:
  - name: Authenticate
  - name: Accounts
  - name: Virtual Accounts
  - name: Online Checkout
  - name: Charge
  - name: Transfers
  - name: Direct Debits
  - name: Terminals
  - name: Transactions
  - name: Airtime and Data Vending
  - name: Electricity Vending
  - name: CableTV Subscription
  - name: Betting Vending
paths:
  /v1/global-payout/accounts:
    get:
      description: >-
        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.
      operationId: Fetch Global Payout Accounts
      parameters:
        - description: Bearer token for authentication.
          in: header
          name: Authorization
          schema:
            type: string
            example: Bearer <token>
          required: true
        - description: The parent accountId of the business.
          in: header
          name: accountId
          schema:
            type: string
            example: 890022ce-bae0-45c1-9b9d-ee7872e6ca27
          required: true
      responses:
        '200':
          description: Accounts retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: '00'
                  description:
                    type: string
                    example: Successful
                  status:
                    type: boolean
                    description: >-
                      Legacy envelope flag. Global Payout endpoints leave it
                      false even on success - read code instead, where 00 means
                      success.
                    example: false
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        accountId:
                          type: string
                          description: >-
                            The wallet id. Pass this value to GET
                            /v1/global-payout/accounts/{accountId} to fetch this
                            account on its own.
                          example: 66bc8c0e054dfe06b69a840a
                        name:
                          type: string
                          example: CbG
                        currency:
                          type: string
                          example: CDF
                        balance:
                          type: number
                          nullable: true
                          description: >-
                            Everything the wallet holds, liens included. Null
                            when the balance could not be read - see status.
                          example: 2770399.5999999996
                        availableBalance:
                          type: number
                          nullable: true
                          description: >-
                            The balance less anything held under lien: what can
                            actually be paid out. Null when the balance could
                            not be read - see status.
                          example: 2770399.5999999996
                        status:
                          type: string
                          enum:
                            - ACTIVE
                            - UNAVAILABLE
                          description: >-
                            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.
                          example: ACTIVE
                        operationRegion:
                          type: string
                          example: CD
                    example:
                      - accountId: 66bc8c0e054dfe06b69a840a
                        name: CbG
                        currency: CDF
                        balance: 2770399.5999999996
                        availableBalance: 2770399.5999999996
                        status: ACTIVE
                        operationRegion: CD
                      - accountId: 66bc8c0ec4973095742cb042
                        name: CbG
                        currency: USD
                        balance: 148000
                        availableBalance: 148000
                        status: ACTIVE
                        operationRegion: CD
                      - accountId: 69e0ec026c2db9fc97911281
                        name: CbG
                        currency: USDT
                        balance: 0
                        availableBalance: 0
                        status: ACTIVE
                        operationRegion: CD
                      - accountId: 69e0ec1223ebafe76aac5651
                        name: CbG
                        currency: USDC
                        balance: 0
                        availableBalance: 0
                        status: ACTIVE
                        operationRegion: CD

````