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.
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.
Simple pricing that scales with your application.
Every plan includes both languages, full history and change tracking.