HealthCodes API
La nomenclature telle qu'elle était
Les factures se contestent des années plus tard. Il faut alors le tarif de ce jour-là — précisément ce qu'un fichier téléchargé aujourd'hui ne contient plus.
Opérationnel en quelques minutes. Résiliable à tout moment.
curl https://api.healthcodesapi.be/v1/codes/101076/history \
-H "Authorization: Bearer YOUR_API_KEY"Un seul paramètre
Chaque requête accepte `?at=AAAA-MM-JJ`. La réponse est la nomenclature telle qu'elle s'appliquait ce jour-là : le libellé publié alors, les montants en vigueur alors, la classification applicable alors.
Pas d'endpoints séparés, pas de second modèle de données. Sans le paramètre, vous obtenez aujourd'hui.
Pourquoi le fichier actuel ne suffit pas
La publication de l'INAMI décrit l'état à sa date d'application. Un montant en vigueur en 2019 et modifié depuis n'y figure plus. Qui veut de l'historique doit avoir conservé et traité chaque publication depuis des années.
Nous l'avons fait et continuons de le faire. L'archive contient aussi les fichiers de mise à jour intermédiaires, que la source retire de son site après environ cinq mois — ces mois manqués sont irrécupérables, et c'est la raison pour laquelle cette tâche tourne tous les jours.
Ce qu'un code ne redevient jamais
Un code qui n'existait pas encore à la date demandée renvoie 404. Le code 101076 existe depuis le 1er septembre 1995 ; demandez-le pour 1990 et vous n'obtenez ni enregistrement, ni enregistrement vide, et surtout pas l'actuel.
`/v1/codes/{code}/history` donne toute la vie d'un code en une réponse : tous les libellés et tous les montants, chacun avec sa période de validité.
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.