HealthCodes API
Rechercher un code de nomenclature
Six chiffres en entrée, tout ce qui a été publié à son sujet en sortie — y compris ce qui y figurait avant.
Opérationnel en quelques minutes. Résiliable à tout moment.
curl https://api.healthcodesapi.be/v1/codes/101076?at=2019-06-01 \
-H "Authorization: Bearer YOUR_API_KEY"Ce que renvoie une recherche
Le libellé dans les deux langues tel que publié, la forme abrégée qui apparaît sur les décomptes, le contexte de prestation, la place dans la classification et la période de validité. Plus la provenance : quelle publication, quelle date d'application, et le SHA-256 de l'archive source.
Ce dernier point n'est pas décoratif. Si quelqu'un demande dans six mois pourquoi vous avez utilisé ce montant, vous pouvez désigner le fichier exact d'où il vient.
Les libellés changent
Un code ne signifie pas toujours la même chose. Les libellés sont versionnés, chacun avec la période pendant laquelle il s'appliquait. Qui relit une facture de 2019 veut la formulation de 2019, pas celle d'aujourd'hui.
`/v1/codes/{code}/descriptions` donne toutes les versions ; `/v1/codes/{code}?at=2019-06-01` donne le code tel qu'il était ce jour-là.
Les codes qui n'existent plus
Sur 31 231 codes, 14 445 ne sont plus en vigueur. Ils ne sont pas supprimés : ils restent consultables avec leur date de fin, car un code supprimé figure encore des années sur d'anciennes factures.
Demandez un code à une date où il n'existait pas encore et vous obtenez un 404, pas l'enregistrement actuel. C'est délibéré : donner discrètement la mauvaise réponse est pire que n'en donner aucune.
HealthCodes API is an independent developer service and is not affiliated with or endorsed by RIZIV/INAMI. Official publications remain authoritative.
Des tarifs simples qui suivent votre application.
Chaque formule inclut les deux langues, l'historique complet et le suivi des modifications.