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

# Saldo en gebruik opvragen

> Gebruik de CometAPI CLI of de API van de query service om accountsaldo, gebruik en quota-details per sleutel op te halen.

CometAPI biedt twee manieren om accountsaldo en gebruik te controleren: de **CometAPI CLI** en de **query service API** op `query.cometapi.com`.

Als je een Workspace gebruikt, zie [Een team beheren met CometAPI Workspace](/nl/workspace/overview) voor informatie over gedeelde Organization Credits en factureringsrollen.

***

## CometAPI CLI

Controleer je saldo vanuit de terminal met één opdracht. Zie [Overzicht van de CometAPI CLI](/nl/libraries/cli/overview) voor installatie.

```bash theme={null}
cometapi balance
```

Voeg `--source token` toe voor details per sleutel:

```bash theme={null}
cometapi balance --source token
```

Zie de [opdrachtenreferentie](/nl/libraries/cli/commands) voor alle beschikbare opties.

***

## Query service API

`GET https://query.cometapi.com/user/quota`

Geeft het accountsaldo, cumulatief gebruik, het totale aantal requests en quota-details per key terug. Dit endpoint gebruikt een aparte queryservice op `query.cometapi.com` en authenticatie verloopt via de queryparameter `key` in plaats van via een Bearer Token.

<Tip>
  Gebruik een aparte API key voor saldocontroles. Als je de blootstelling wilt beperken, schakel dan Unlimited Quota uit en stel de kleinste positieve kredietlimiet in die door het dashboard is toegestaan.
</Tip>

### Requestparameters

| Parameter    | Type   | Required | Description                                                     |
| ------------ | ------ | -------- | --------------------------------------------------------------- |
| `key`        | string | Yes      | Je CometAPI API key                                             |
| `start_date` | string | No       | Startdatum voor dagelijkse uitsplitsing (indeling `YYYY-MM-DD`) |
| `end_date`   | string | No       | Einddatum voor dagelijkse uitsplitsing (indeling `YYYY-MM-DD`)  |

Wanneer `start_date` en `end_date` zijn opgegeven, bevat de response een veld `daily_quota` met gebruik per key, uitgesplitst per dag.

### Responsevelden

| Field                               | Type    | Description                                                                                |
| ----------------------------------- | ------- | ------------------------------------------------------------------------------------------ |
| `username`                          | string  | Gebruikersnaam                                                                             |
| `total_quota`                       | number  | Huidig accountsaldo (USD)                                                                  |
| `total_used_quota`                  | number  | Cumulatief gebruik (USD)                                                                   |
| `request_count`                     | integer | Totaal aantal requests                                                                     |
| `keys`                              | array   | Quota-details per key                                                                      |
| `keys[].name`                       | string  | Naam van de API key                                                                        |
| `keys[].remain_quota`               | number  | Resterend quota van de key; `-1` betekent onbeperkt                                        |
| `keys[].used_quota`                 | number  | Verbruikt quota van de key; `-1` betekent onbeperkt                                        |
| `daily_quota`                       | object  | Dagelijkse gebruiksuitsplitsing (alleen wanneer `start_date` en `end_date` zijn ingesteld) |
| `daily_quota[date]`                 | array   | Gebruiksoverzichten per key voor die datum                                                 |
| `daily_quota[date][].token_name`    | string  | Naam van de API key                                                                        |
| `daily_quota[date][].quota_used`    | number  | Gebruik voor die key op die datum (USD)                                                    |
| `daily_quota[date][].request_count` | integer | Aantal requests voor die key op die datum                                                  |

### Codevoorbeelden

Accountsaldo opvragen:

<CodeGroup>
  ```bash curl theme={null}
  curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
  ```

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

  resp = requests.get(
      "https://query.cometapi.com/user/quota",
      params={"key": os.environ["COMETAPI_KEY"]}
  )
  data = resp.json()
  print(f"Balance: ${data['total_quota']:.2f}")
  print(f"Used: ${data['total_used_quota']:.2f}")
  print(f"Requests: {data['request_count']}")
  ```

  ```javascript Node.js theme={null}
  const resp = await fetch(
    `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
  );
  const data = await resp.json();
  console.log(`Balance: $${data.total_quota.toFixed(2)}`);
  console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
  console.log(`Requests: ${data.request_count}`);
  ```
</CodeGroup>

### Responsevoorbeeld

```json theme={null}
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "keys": [
    {
      "name": "my-key",
      "remain_quota": 8.94,
      "used_quota": 2.10
    }
  ]
}
```

### Voorbeeld van dagelijkse uitsplitsing

Dagelijks gebruik voor een datumbereik opvragen:

```bash theme={null}
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
```

De response bevat dezelfde velden op het hoogste niveau plus `daily_quota`:

```json theme={null}
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "daily_quota": {
    "2026-04-13T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 4.27,
        "request_count": 59
      }
    ],
    "2026-04-14T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 0.57,
        "request_count": 36
      }
    ]
  }
}
```