Codes

The core resource. 31,231 codes, each with descriptions, classification and validity.

Endpoints

Method	Path	Returns
`GET`	/v1/codes	A page of codes
`GET`	/v1/codes/{code}	One code
`GET`	/v1/codes/{code}/descriptions	Description versions
`GET`	/v1/codes/{code}/tariffs	Amounts in force
`GET`	/v1/codes/{code}/history	Every version of everything
`GET`	/v1/codes/{code}/changes	This code's change events

Filters

Parameter	Values	Notes
`active`	true / false	In force today.
`valid_at`	YYYY-MM-DD	In force on a date. Developer plan.
`category`	nomenclature, pseudo_nomenclature, implant, outside_billing_circuit
`chapter`	e.g. CH02
`article`	e.g. 2, 27/1, 35bis	Percent-encode: article ids contain / and §.
`sub_article`	e.g. 2B
`changed_since`	date or RFC-3339	Developer plan.

Examples

GET /v1/codes?chapter=CH02&active=true&limit=100
GET /v1/codes?article=27%2F1
GET /v1/codes?category=implant

category

9,378 of 31,231 codes are not nomenclature proper. They are returned by default and always labelled, because hiding them would be tidier and less honest — but if your software bills against them, check this field.

category	Count	Meaning
`nomenclature`	21,853	Nomenclature proper.
`pseudo_nomenclature`	6,196	Pseudo-nomenclature.
`implant`	3,145	Implant prestation number.
`outside_billing_circuit`	37	Explicitly outside the ZIV/AMI billing circuit.

active

Derived from valid_to against today, never stored, so it cannot go stale. A code with no end date is active; one whose end date has passed is not.