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.