HealthCodes API
Een nomenclatuurcode opzoeken
Zes cijfers in, alles wat erover gepubliceerd is eruit — inclusief wat er vroeger stond.
In enkele minuten aan de slag. Maandelijks opzegbaar.
curl https://api.healthcodesapi.be/v1/codes/101076?at=2019-06-01 \
-H "Authorization: Bearer YOUR_API_KEY"Wat één opzoeking teruggeeft
De omschrijving in beide talen zoals gepubliceerd, de korte vorm die op afrekeningen verschijnt, de verstrekkingscontext, de plaats in de classificatie en de periode waarin de code geldig is. Plus de herkomst: welke publicatie, met welke toepassingsdatum, en de SHA-256 van het bronarchief.
Die laatste is geen decoratie. Als iemand over zes maanden vraagt waarom je dat bedrag gebruikte, kun je het exacte bestand aanwijzen waaruit het komt.
Codes veranderen van omschrijving
Een code betekent niet altijd hetzelfde. De omschrijvingen zijn geversioneerd, elk met de periode waarin ze golden. Wie een factuur uit 2019 naleest, wil de bewoording van 2019 zien en niet die van vandaag.
`/v1/codes/{code}/descriptions` geeft alle versies; `/v1/codes/{code}?at=2019-06-01` geeft de code zoals hij die dag was.
Codes die niet meer bestaan
Van de 31.231 codes zijn er 14.445 niet meer geldig. Die worden niet weggegooid: ze blijven opvraagbaar met hun einddatum, want een afgeschafte code staat nog jaren op oude facturen en dossiers.
Vraag je een code op met een datum waarop hij nog niet bestond, dan krijg je een 404 en niet het huidige record. Dat is bewust: stilletjes het verkeerde antwoord geven is erger dan geen antwoord.
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.