# API

> Met de Hirro-API lezen je eigen tools materieel, zones, fases en waarnemingen, sturen ze materieel in, en ontvangen ze gebeurtenissen via webhooks.

Last updated: 2026-11-06

De Hirro-API geeft je eigen tools dezelfde gegevens als het dashboard. Lees materieel met zijn zones, fases en historiek, stuur materieel in vanuit je materieelregister, en ontvang webhooks wanneer er iets verandert, zoals materieel dat het depot verlaat. Ze past bij BI-tools, eigen ERP-koppelingen en interne apps.

:::note
Deze pagina beschrijft wat de API omvat. De referentie met endpoints en velden volgt zodra de specificatie gepubliceerd is.
:::

## Wat kan ik lezen via de API?

| Resource | Wat het bevat |
|---|---|
| Materieel | Nummer, naam, type, zone, fase, laatste waarneming, ouder en ERP-artikel |
| Sites en zones | De sites die je instelde en de zones die erop getekend zijn |
| Waarnemingen | Welke lezer welke tag hoorde, en wanneer |
| Gebeurtenissen | Zonewissels, fasewissels, vertrekken en terugkomsten |
| Tags | Elke tag, zijn materieel en zijn batterijniveau |

## Wat kan ik schrijven via de API?

Materieel aanmaken en bijwerken, bijvoorbeeld vanuit je materieelregister, en tags aan materieel koppelen.

## Waarvoor dienen webhooks?

Webhooks sturen een gebeurtenis naar je systeem op het moment dat ze gebeurt, zodat je niet hoeft te pollen. Typische gebeurtenissen zijn materieel dat van zone of fase wisselt, materieel dat door de poort vertrekt of terugkomt, en een aanbouwdeel dat niet met zijn ouder terugkwam.

## Welk plan bevat de API?

De API zit in de plannen Scale en Enterprise. Zie [Plannen](/nl/reference/plans/).