Documentation

What you get

• 31,231 nomenclature codes, each with a Dutch and a French description as published, a category, a validity period and a place in the chapter/article structure.
• 1.7 million published amounts — tariffs, reimbursements and patient co-payments — each labelled with what kind of amount it is and which reimbursement regime it applies to.
• Full history. Every versioned fact keeps the period it applied to, so ?at=2022-03-01 answers what was true then rather than what is true now.
• A change feed with before and after values and the date each change took effect.

Conventions

These hold everywhere, so they are worth reading once.

• Authentication is a bearer token: Authorization: Bearer hcapi_live_….
• Collections return { data, pagination }. Single resources return the object directly.
• Dates are ISO-8601 (YYYY-MM-DD). Validity ranges are inclusive at both ends, and an absent valid_to means open-ended.
• Amounts are strings in EUR, with the precision the source published. They are money, so they are never floats — and 0.00 is a value, not an absence.
• Errors all share one envelope with a stable machine-readable code.

Start here

• Quickstart — from nothing to a real response.
• Dates & history — the part most people get wrong.
• Amounts & tariffs — why one code has eighteen numbers.

Independence

HealthCodes API is an independent developer service, not affiliated with or endorsed by RIZIV/INAMI. See sources & methodology for where the data comes from and how it is processed.