Patient first name.

Patient last name.

Patient language.

Patient creation date.

Patient update date.

Patient synchronization date.

Patient date of birth. Must be strictly before today.

Patient gender.

Patient email address.

Patient phone number.

Patient birth name, when it differs from the current legal name. Helps front-desk identity checks and the social-security link (the NIR is tied to the birth name). Not a dedup key: patient matching uses the NIR, or first name + last name + date of birth.

Free-text practice notes about the patient record.

Critical medical information (allergies, medical risks) meant to be surfaced prominently on the patient record, not buried in notes.

The patient's declared "médecin traitant" (GP registered with health insurance), as free text.

Patient anonymous code.

Patient street address.

Patient postal code.

Patient city.

Patient record/folder number from the source software (e.g. Logosw).

Patient height in centimeters.

Patient weight in kilograms.

How the patient is addressed: mr | mrs | dr | pr | none. Null means nobody has declared it — clients fall back to the gender-derived form. Distinct from gender: a patient who is a doctor is addressed "Dr" whatever their gender.

Civil-status given names in order, the first being the birth first name. Distinct from firstName, which stays the name the patient goes by. Populated from the Vitale card when available.

INSEE (COG) code of the birthplace, an INS identity trait. Five characters — Corsican codes are 2A/2B and a birth abroad carries a 99xxx country code.

National health identity (INS) matricule. Distinct from socialSecurityNumber: the NIR is the number the patient is covered under and may belong to a parent, the INS identifies the patient themselves.

OID qualifying the INS matricule: 1.2.250.1.213.1.4.8 for a NIR, 1.2.250.1.213.1.4.9 for a NIA (temporary identifier).

INS qualification status: provisional | validated | retrieved | qualified. Only a qualified identity may be carried into an interoperable exchange (DMP, MSSanté, FSE). Read-only: the server derives it from the matricule's provenance — a manually entered matricule reads back as provisional.

Where the INS came from: manual | vitale | insi | import. Confidence levels — only the INSi teleservice can qualify an identity. Read-only: a matricule written through this API is manual by construction.

When the identity first became qualified, i.e. when both RNIV determinants were met. Read-only: only the document check and the INSi teleservice can produce a qualification.

When the identity traits were last checked against an identity document. Read-only — set by the validation endpoint.

Which kind of high-trust identity document the traits were checked against. Read-only. The document number is never stored — the CNIL forbids it.

Whether the applicable coverage was certified by an online rights check (Vitale, ADRi or ApCV). Read-only, derived from the patient coverages — write rights through the coverage endpoints.

When the online rights check certified the coverage (ISO 8601). Null when rights were never verified online.

What this record still needs, as stable codes: postal_address_missing, rights_to_verify. Wording is the client's. Contributions from other bricks (missing consents, unsigned quotes) are aggregated by the "À traiter" endpoints.

RNIV strict traits missing from this record, as stable codes: birth_name, birth_given_name, birth_date, sex. Empty when the record is complete. A non-empty list means the INSi endpoints will refuse this record: fill these before calling them.

What the INS matricule is, read from its OID: nir for a definitive identifier, nia for a provisional one still awaiting a NIR. Null when the record carries no INS, or an OID outside the two documented namespaces.

All phone numbers, primary first. The primary one is also served as the legacy phone field. smsCapable is true only for a number labelled mobile — reminders never target the others.

All email addresses, primary first. The primary one is also served as the legacy email field.