HealthCodes API
Een RIZIV API die er officieel niet is
Het RIZIV publiceert de nomenclatuur als ZIP-bestanden, niet als API. Deze dienst maakt er wel een van: 31.231 codes, 1,7 miljoen bedragen, opvraagbaar per code en per datum.
curl https://api.healthcodesapi.be/v1/codes/101076 \
-H "Authorization: Bearer YOUR_API_KEY"Heeft het RIZIV zelf een API?
Voor de referentietabellen van de nomenclatuur niet. Het RIZIV publiceert ze als een ZIP van ruim 60 MB met pipe-gescheiden tekstbestanden, aangevuld met een spreadsheet die de kolomindeling beschrijft. Er is geen endpoint, geen versiecontract en geen manier om te vragen wat er sinds vorige maand veranderd is.
Dat is een verdedigbare manier om een dataset te publiceren en een lastige manier om er software op te bouwen. Deze API sluit dat gat: dezelfde gegevens, genormaliseerd, geïndexeerd en adresseerbaar per code.
Wat er in zit
31.231 nomenclatuurcodes, waarvan er vandaag 16.786 geldig zijn. Elke code heeft een Nederlandse én een Franse omschrijving zoals gepubliceerd: voor alle 31.231, geen enkele ontbreekt: plus een hoofdstuk, artikel, subartikel en geldigheidsperiode.
Daarnaast 1.737.188 gepubliceerde bedragen. Eén code draagt meerdere bedragen, omdat het honorarium, de tegemoetkoming en het persoonlijk aandeel elk apart gepubliceerd worden, en dat nog eens gesplitst naar voorkeurregeling.
Wat je met de bestanden zelf niet kunt
Vragen wat er gisteren veranderd is. De archieven dragen een timestamp uit 2018 ongeacht hun inhoud, dus je kunt aan HTTP niet zien of er iets bewogen is. Wij houden 593.281 wijzigingsgebeurtenissen bij sinds 1 januari 2015, opvraagbaar per code, per maand of per periode.
En vragen wat een code op een bepaalde dag was. Elke bevraging aanvaardt `?at=JJJJ-MM-DD` en antwoordt met de nomenclatuur zoals ze die dag gold, wat je nodig hebt bij een factuur van drie jaar geleden, niet het tarief van vandaag.
Eenvoudige prijzen die meegroeien met uw toepassing.
Elk abonnement bevat beide talen, de volledige historiek en wijzigingsdetectie.