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

# Get Single Wallet Balance

> Retrieve balance and details for a specific currency.

Fetches the balance of a single currency wallet by its currency code.

### Scopes required

`wallets:read` or `*`

### Path parameters

<ParamField path="currency" type="string" required>
  The uppercase currency code (e.g. `NGN`, `USD`).
</ParamField>

### Headers

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

### Response

<ResponseField name="id" type="string">
  Unique wallet UUID.
</ResponseField>

<ResponseField name="currency" type="string">
  The requested currency code.
</ResponseField>

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

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

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/wallets/NGN", {
    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/NGN",
      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"
  }
  ```
</ResponseExample>


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