Skip to content
autonym.dev
ContentsHide contents

Levels

Each entry in the record can be rendered at up to four levels. A grant sets a ceiling per domain; the compiler renders each entry at or below it.

A level is a ceiling, never a licence. A recipient MUST hold a valid grant for every domain it reads, including at L0, and a recipient without one receives no record content and no category-presence information. There is no level a recipient reaches by authenticating alone.

L0Categories
Categories only, no valuesWhether a permitted category is present, without its detailed values.
L1Preferences
Preferences and needs, no direct identifiersPreferences and needs with direct identifying details removed.
L2Named
First names and household relationshipsMore specific details, which can include first names and household relationships.
L3Identified
Identifying detailsIdentifying details held in the record, such as full names and contact information.

What L1 removes

Personal names. Exact dates of birth (age bands are returned instead). Addresses below region. Phone numbers, email addresses, account and loyalty numbers. Employer and institution names.

Free text

Automatic redaction of free text is not reliable, so for free-text values the L1 rendering is a string the person approved, held in rendering_overrides.L1. If none exists, the entry is not returned at L1.

Keys that stop early

Not every key supports every level. The vocabulary states which. A coffee order has no L3. A medical alert returns no more than its category presence at L0, which is why L0 needs a grant of its own: knowing that a person has a medical alert is itself disclosure.

EntryL0L1L2L3
HouseholdIncludes minorsPartner and two children under 10Partner Sam; Ella (8), Noah (5)Full names and dates of birth
Food allergyHas a food allergyTree nuts, severeTree nuts, severe; carries an adrenaline penPlus the prescribing clinician
CoffeeHas a drink preferenceFlat white, oat milk, extra shotSameSame
MobilityHas an access needWheelchair user, needs step-free accessPlus chair dimensionsPlus a contact for assistance