HealthCodesAPI

Amounts & tariffs

A code does not have 'a price'. It has a tariff, what the insurer reimburses, and what the patient pays — usually twice over, for two reimbursement regimes.

The shape of an amount

One amount
{
  "code": "101076",
  "kind": "reimbursement",
  "regime": "standard",
  "fee_code": 1600,
  "fee_code_description": {
    "nl": "Tegemoetkoming rechthebbenden zonder voorkeurregeling",
    "fr": "Intervention bénéficiaires sans régime préférentiel"
  },
  "amount": "27.740000",
  "currency": "EUR",
  "valid_from": "2026-01-01"
}

kind

ValueMeaning
feeThe tariff — what the service costs.
reimbursementWhat the insurer covers.
patient_shareWhat the patient pays (ticket modérateur / remgeld).
flat_rateA forfaitary amount.
maximum_tariffA ceiling.
supplementAn addition.
otherAnything we cannot classify confidently. Deliberately not guessed.

regime

preferential or standard, where the source distinguishes them, and not_applicable where it does not. Beneficiaries with the preferential regime are reimbursed at a higher rate: on a €33.74 consultation that is the difference between paying €1.50 and paying €6.00.

fee_code

The source's own identifier for what this amount is. Several fee codes can share a kind while differing in context — inside a care trajectory, for a beneficiary with a global medical record, for patients up to 24. The bilingual description says which.

Amounts are strings

Always. They are money, and a JSON number is a double in most clients. Parse them with a decimal type, and do not round them before you have to.

Zero is a value

28% of published amounts are exactly 0.00. What that means depends on the fee code: for code 101076 the patient share inside a care trajectory is €0.00, alongside €1.50 in the ordinary case. We return 0.00, never null, and never call it free.

We never compute an amount

The nomenclature has a key-letter system where a tariff is nominally a coefficient times a letter value. That reproduces the published figure for 9,609 codes and fails for 1,352 — sometimes by a factor of four. So only published amounts are served. Key letters are available as descriptive metadata; do not multiply them out.