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

# List All Wallets

> Retrieve balances across all active merchant wallets.

Returns balances across all active currency wallets associated with your merchant account. Amounts are represented in minor currency units (e.g. kobo or cents as strings).

### Scopes required

`wallets:read` or `*`

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer API secret key formatted as `Bearer sk_live_...` or `Bearer sk_test_...`.
</ParamField>

### Response

<ResponseField name="wallets" type="array">
  List of wallet objects.

  <Expandable title="Wallet properties">
    <ResponseField name="id" type="string">
      Unique wallet UUID.
    </ResponseField>

    <ResponseField name="currency" type="string">
      Currency code (e.g. `NGN`, `USD`).
    </ResponseField>

    <ResponseField name="balanceMinor" type="string">
      Current balance in minor units (e.g. `145000000` = 1,450,000.00 NGN).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tabsglobal.co/v1/wallets" \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/wallets", {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
    },
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tabsglobal.co/v1/wallets",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
      "currency": "NGN",
      "balanceMinor": "145000000"
    },
    {
      "id": "b2c3d4e5-f6a7-4b5c-9d0e-1f2a3b4c5d6e",
      "currency": "USD",
      "balanceMinor": "825000"
    }
  ]
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.