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

# Query Your KiosAPI Account Balance and Usage Information

> Retrieve your KiosAPI account details — including account ID, username, balance, and total usage — via GET /v1/dashboard/billing/account.

Retrieve your account details — including your account ID, username, current balance, and cumulative usage — via the KiosAPI billing API. This endpoint is useful for building internal dashboards, usage alerts, or automated budget checks within your own tooling.

## Request

**Method:** `GET`
**URL:** `https://kiosapi.com/v1/dashboard/billing/account`

### Headers

| Header          | Required | Description     |
| --------------- | -------- | --------------- |
| `Authorization` | Yes      | `Bearer sk-xxx` |

### Examples

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl https://kiosapi.com/v1/dashboard/billing/account \
      -H "Authorization: Bearer sk-xxx"
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    url = "https://kiosapi.com/v1/dashboard/billing/account"
    headers = {"Authorization": "Bearer sk-xxx"}

    response = requests.get(url, headers=headers)
    data = response.json()

    print(f"Account ID: {data.get('id')}")
    print(f"Balance: ${data.get('balance', 0)}")
    ```
  </Tab>
</Tabs>

## Response

A successful request returns an account object with your current balance and usage:

```json theme={null}
{
  "id": "user-xxx",
  "username": "your-email@example.com",
  "balance": 10.50,
  "used": 3.25,
  "created_at": 1686935002
}
```

### Response Schema

| Field        | Type    | Description                                    |
| ------------ | ------- | ---------------------------------------------- |
| `id`         | string  | Your unique KiosAPI account identifier         |
| `username`   | string  | The email address associated with your account |
| `balance`    | number  | Remaining credit balance in USD                |
| `used`       | number  | Total spend to date in USD                     |
| `created_at` | integer | Unix timestamp of when the account was created |

<Tip>
  For the most up-to-date account information, check your [Dashboard](https://kiosapi.com) directly at kiosapi.com.
</Tip>