HealthCodes API
De nomenclatuur zoals ze toen gold
Facturen worden jaren later betwist. Dan heb je het tarief van die dag nodig, en dat is precies wat een downloadbestand van vandaag niet meer bevat.
In enkele minuten aan de slag. Maandelijks opzegbaar.
curl https://api.healthcodesapi.be/v1/codes/101076/history \
-H "Authorization: Bearer YOUR_API_KEY"Eén parameter
Elke bevraging aanvaardt `?at=JJJJ-MM-DD`. Het antwoord is de nomenclatuur zoals ze die dag gold: de omschrijving die toen gepubliceerd was, de bedragen die toen golden, de classificatie die toen van toepassing was.
Geen aparte endpoints, geen tweede datamodel. Laat je de parameter weg, dan krijg je vandaag.
Waarom het bestand van vandaag niet volstaat
De publicatie van het RIZIV beschrijft de toestand op haar toepassingsdatum. Een bedrag dat in 2019 gold en sindsdien gewijzigd is, staat er niet meer in. Wie historiek wil, moet elke publicatie sinds jaren bewaard én verwerkt hebben.
Wij hebben dat gedaan en blijven het doen. Het archief bevat ook de tussentijdse wijzigingsbestanden, die de bron na vijf maanden van zijn site haalt — die gemiste maanden zijn onherstelbaar, en dat is de reden dat die job elke dag draait.
Wat een code nooit meer wordt
Een code die op de opgevraagde datum nog niet bestond, geeft 404. Code 101076 bestaat sinds 1 september 1995; vraag hem op voor 1990 en je krijgt geen record, geen leeg record en zeker niet het huidige.
`/v1/codes/{code}/history` geeft het hele leven van één code in één antwoord: alle omschrijvingen en alle bedragen, elk met hun geldigheidsperiode.
HealthCodes API is an independent developer service and is not affiliated with or endorsed by RIZIV/INAMI. Official publications remain authoritative.
Eenvoudige prijzen die meegroeien met uw toepassing.
Elk abonnement bevat beide talen, de volledige historiek en wijzigingsdetectie.