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

# Balance

> Check your account balance with the /api/stealthify/balance endpoint

The `/api/stealthify/balance` endpoint allows you to check your current account balance and available words without making any content generation requests.

## Request Parameters

<ParamField header="api-token" type="string" required>
  Your unique API authentication token. You can find this in your StealthGPT dashboard under the API Key tab.
</ParamField>

## Response

<ResponseField name="credits" type="number">
  Number of words available in your account
</ResponseField>

<ResponseField name="payg" type="object | null">
  Pay-as-you-go (metered) billing status and any usage pending billing. When `null`, the account is not enrolled in metered billing.
</ResponseField>

<ResponseField name="payg.mode" type="string">
  Current pay-as-you-go billing mode. One of `metered_active`, `metered_past_due`, or `metered_setup_required`.
</ResponseField>

<ResponseField name="payg.unbilledCredits" type="number">
  Words accumulated for metered billing that have not yet been reported/flushed.
</ResponseField>

<ResponseField name="payg.lastUsageReportAt" type="string (ISO 8601 date-time) | null">
  Last time metered usage was reported/flushed (ISO 8601 date-time string).
</ResponseField>

## Example Request

<CodeGroup>
  ```bash curl-example theme={null}
  curl --location 'https://stealthgpt.ai/api/stealthify/balance' \
      --header 'api-token: YOUR_API_TOKEN'
  ```

  ```python python-example theme={null}
  import requests

  response = requests.get(
      'https://stealthgpt.ai/api/stealthify/balance',
      headers={
          'api-token': 'YOUR_API_TOKEN'
      }
  )

  print(response.json())
  ```

  ```javascript nodejs-example theme={null}
  const axios = require('axios');

  axios.get('https://stealthgpt.ai/api/stealthify/balance', {
      headers: {
          'api-token': 'YOUR_API_TOKEN'
      }
  }).then(response => {
      console.log(response.data);
  });
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "credits": 985000,
  "payg": {
    "mode": "metered_active",
    "unbilledCredits": 12450,
    "lastUsageReportAt": "2026-02-13T10:15:30.000Z"
  }
}
```

## Usage Notes

* This endpoint is lightweight and can be called frequently to track your balance
* No words are consumed when checking your balance
* Use this endpoint to implement balance tracking in your applications or to check before making requests