HealthCodes API
Looking up a nomenclature code
Six digits in, everything ever published about them out — including the wordings and amounts that have since been replaced.
Start in minutes. Cancel any time.
curl https://api.healthcodesapi.be/v1/codes/101076?at=2019-06-01 \
-H "Authorization: Bearer YOUR_API_KEY"What one lookup returns
The description in both languages as published, the short form that appears on statements, the care setting, the position in the classification tree and the validity period. Plus provenance: which publication, which application date, and the SHA-256 of the source archive.
That last field is the one people underestimate. Six months later, when somebody asks why your software used that amount, you can point at the exact file it came from rather than at a screenshot.
A code does not always mean the same thing
Descriptions are versioned, each tied to the period it applied to. Code 101076 has carried several Dutch wordings since 1995. Reading a 2019 invoice with today's wording is how a dispute starts, not how it ends.
`/v1/codes/{code}/descriptions` returns every version; `?at=2019-06-01` on any request returns the code as it stood that day.
Codes that no longer exist
Of 31,231 codes, 14,445 are no longer valid. They are not deleted: they stay retrievable with their end date, because a withdrawn code keeps appearing on old invoices and in old records for years.
Ask for a code at a date before it existed and you get a 404, not the current record. That is deliberate. Quietly returning the wrong answer is worse than returning none.
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.