Guides
  1. Integration Guides

Fetch Organization Accounts

List your organization accounts, fetch a specific account by ID, and review balances before funding or transactions.

Get your organization accounts and balances so you can choose the right account for funding and transactions.

Prerequisites

  1. Set your NadaPay API base URL in $baseUrl.
  2. Export your NadaPay API key as YOUR_API_KEY.

Step 1 — List all accounts

curl --request GET \
  --url $baseUrl/organizations/accounts \
  --header 'x-api-key: YOUR_API_KEY'

Response:

{
  "data": [
    {
      "id": "acct_01HXXXXXXXXXXXXXXXXXX",
      "label": "Main Operations",
      "status": "active",
      "created_at": "2025-01-01T00:00:00Z"
    },
    {
      "id": "acct_01HYYYYYYYYYYYYYYYYYY",
      "label": "Vendor Payouts",
      "status": "active",
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Step 2 — Fetch a specific account by ID

curl --request GET \
  --url $baseUrl/organizations/accounts/acct_01HXXXXXXXXXXXXXXXXXX \
  --header 'x-api-key: YOUR_API_KEY'

Step 3 — Filter accounts by currency and status

curl --request GET \
  --url $baseUrl/organizations/accounts?currency=USD&status=active \
  --header 'x-api-key: YOUR_API_KEY'

Use the returned account balances to determine whether an account has sufficient funds for a transaction.

📘

See Get Currency Balance for the balance endpoint in the API Reference.

What's next

Updated about 1 month ago