HealthCodes API
Search and retrieve RIZIV nomenclature codes
Look a code up by number, or find one by describing it — in Dutch or in French.
Start in minutes. Cancel any time.
curl https://api.healthcodesapi.be/v1/search?q=raadpleging&language=nl \
-H "Authorization: Bearer YOUR_API_KEY"Searching by description, not just by number
Most lookups do not start with a number. They start with someone typing "raadpleging huisarts" or "consultation cabinet". Search ranks exact code matches first, then code prefixes, then exact text, then text prefixes, then relevance, then fuzzy — so a number never loses to a description that happens to mention it.
Dutch and French are indexed with their own language rules, so stemming works in both. Accents are optional on input.
What a code carries
Its category — nomenclature, pseudo-nomenclature, an implant number, or a code explicitly outside the ZIV/AMI billing circuit. Its validity period. Its chapter, article and sub-article. Its care setting, ambulatory or hospitalised. And both official descriptions.
9,378 of the 31,231 codes are not nomenclature proper. They are returned, always labelled, and filterable — hiding them would be tidier and less honest.
Filtering a list
`/v1/codes` supports `active`, `category`, `chapter`, `article`, `sub_article` and `changed_since`, with cursor pagination that stays stable while the underlying data moves.
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.