HealthCodes API
Reference data for Belgian medical billing software
Validate a code and an amount against the date the care actually happened — not against today.
Start in minutes. Cancel any time.
curl https://api.healthcodesapi.be/v1/codes/101076?at=2022-03-01 \
-H "Authorization: Bearer YOUR_API_KEY"Billing is a question about the past
A record entered today may describe care given months ago, and the amount that applied then is the amount that applies to it. A reference dataset that only knows the current state cannot validate it, and will quietly approve the wrong figure.
Every endpoint here takes `?at=`, with both bounds inclusive. Ask what code 101076 cost on 2022-03-01 and you get €27.25, which is what it cost.
Codes that are not billable
37 codes are explicitly published as being outside the ZIV/AMI billing circuit, and another 9,341 are pseudo-nomenclature or implant numbers rather than nomenclature proper. Every code returned carries its category, so billing logic can refuse what it should refuse.
Knowing when something changed
The Changes API reports each change with its before value, its after value and the date it took effect, so a billing system can reconcile rather than re-import. Belgian tariffs move mostly on 1 January, but not only then.
What this does not do
It does not submit claims, hold patient data, or decide entitlement. It tells you what was published. The rules about who may bill what remain in the official publications.
HealthCodes API is an independent developer service and is not affiliated with or endorsed by RIZIV/INAMI. Official publications remain authoritative.
Simple pricing that scales with your application.
Every plan includes both languages, full history and change tracking.