HealthCodes API
What the patient actually pays
The patient's share is published. You do not have to derive it from fee minus reimbursement — and you should not want to.
Start in minutes. Cancel any time.
curl https://api.healthcodesapi.be/v1/codes/101076/tariffs \
-H "Authorization: Bearer YOUR_API_KEY"Why subtraction is not enough
Fee minus reimbursement looks like it gives the copayment, and for many codes it does. But the source publishes the patient's share separately, and where the two disagree the published value is the right one. Computing it yourself means sometimes showing a different number from the one the insurer applies.
For code 101076, a consultation with an accredited GP: €33.74 fee, €27.74 reimbursement, €6.00 patient share. Under the preferential regime: €32.24 and €1.50. Every one of those comes straight out of the publication.
The preferential regime is its own row
Almost every amount exists twice: with and without increased reimbursement. They are separate rows with their own fee code, not a percentage to apply to a base amount.
Apply the percentage yourself and you get rounding differences of a few cents — which is exactly what shows up as an error in a billing audit.
Zero is a published number
490,083 of the 1,737,188 published amounts are exactly €0.00. What that means depends on the fee code: for 101076 the patient share inside a care trajectory is €0.00, alongside €1.50 in the ordinary context.
We return `0.00`, never `null`, and never call it free. A published zero is a fact; a zero standing in for missing data is a bug.
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.