> 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 het aantal calls met het credittarief van de betreffende API. Zie [Credittarieven](https://app.slack.com/ontwikkelaars/credittarieven).
{% endhint %}

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

Deze API heette voorheen de Credit API. Omdat “credit” in het nieuwe platform een afrekeneenheid is (1 credit = € 0,05) en deze API juist het aantal calls teruggeeft, hebben we de naam verduidelijkt naar Verbruik-API.

{% hint style="info" %}
Het endpoint zelf verandert niet. Het pad `/credit` blijft ongewijzigd en volledig ondersteund werken, 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 retourneert een JSON-antwoord met jouw API gebruik per API voor het opgegeven aantal uren. Door een tijdparameter toe te voegen, kunt u het tijdsbereik van het verzoek in uren opgeven.

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

### Dien een GET-verzoek in bij de API om uw gebruikte API verbruik te ontvangen. Geef uw tijdsbereik op met de tijdqueryparameter

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

#### Query Parameters

| Name | Type    | Description                  |
| ---- | ------- | ---------------------------- |
| time | integer | Tijdbereik 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" %}
{\
"interactivereference-api": "6", \
"rebuildapi": "1", \
"objectdataapi": "1" \
}
{% endtab %}

{% tab title="403: Forbidden" %}
{ "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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.