> For the complete documentation index, see [llms.txt](https://docs.altum.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altum.ai/ontwikkelaars/verbruik-api.md).

# Verbruik-API

Verbruik-API is een hulpprogramma-API waarmee je jouw gebruikte Altum-credits kunt bijhouden.

De **Verbruik-API** geeft je inzicht in je API-gebruik: het aantal calls dat je per API hebt gemaakt binnen een gekozen periode. Handig om je verbruik te monitoren, integraties te controleren en call-gebaseerde checks in te richten.

{% hint style="info" %}
**Let op: aantal calls, geen credits** De Verbruik-API rapporteert het *aantal calls* per API, niet het aantal verbruikte credits of je resterende tegoed. In het creditmodel kost elke API een eigen aantal credits per call. Wil je van calls naar credits, vermenigvuldig dan het aantal calls met de creditwaarde van die API. Zie [Credits per API](/platform/credits-per-api.md).
{% endhint %}

#### Naamswijziging: van Credit API naar Verbruik-API

Deze API heette voorheen de Credit API. Een credit is een afrekeneenheid (1 credit = € 0,05) en deze API geeft het aantal calls terug. Daarom heet hij Verbruik-API.

{% hint style="info" %}
Het endpoint zelf verandert niet. Het pad `/credit` blijft ongewijzigd en volledig ondersteund, zodat bestaande integraties, inclusief Enterprise-checks, zonder aanpassing blijven functioneren. Je hoeft niets te wijzigen.
{% endhint %}

#### Een GET-verzoek

Een GET-verzoek aan de Verbruik-API geeft een JSON-antwoord met het aantal calls per API. Met de parameter `time` geef je het tijdsbereik in uren op. Zonder parameter is dat 24 uur.

{% hint style="info" %}
Er zit een latentie van 60 seconden tussen een call en de aanwezigheid ervan in de Verbruik-API.
{% endhint %}

### Doe een GET-verzoek om je call-aantallen te ontvangen. Geef het tijdsbereik op met de queryparameter time

<mark style="color:blue;">`GET`</mark> `https://api.altum.ai/credit`

#### Query Parameters

| Name | Type    | Description                   |
| ---- | ------- | ----------------------------- |
| time | integer | Tijdsbereik in uren. Bijv. 24 |

#### Headers

| Name                                        | Type   | Description         |
| ------------------------------------------- | ------ | ------------------- |
| x-api-key<mark style="color:red;">\*</mark> | string | Geldige API-sleutel |
| Content-Type                                | string | application/json    |

{% tabs %}
{% tab title="200: OK succesvol" %}

```json
{
  "interactivereference-api": "6",
  "rebuildapi": "1",
  "objectdataapi": "1"
}
```

{% endtab %}

{% tab title="403: Forbidden" %}

```json
{ "message": "Forbidden" }
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.altum.ai/credit
?time=40
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
  "interactivereference-api": 1307,
  "avmapi": 671,
  "wozapi": 209,
  "sustainabilityapi": 85,
  "energylabelapi": 390
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.altum.ai/ontwikkelaars/verbruik-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.