Update per-employee pension rates
Update an employee’s per-employee pension contribution rates. Creates a new membership history version effective from the specified valid_from date. Override rates must be >= the scheme minimums (HMRC AE compliance). If tax_treatment is overridden, wage_type_code must also be provided.
Body
Request to update per-employee pension contribution rates.
Creates a new membership history version effective from valid_from. Standard PATCH semantics:
- Field omitted from the request body → carry forward the current value unchanged.
- Field explicitly set to null → clear the override (fall back to scheme default).
- Field set to a value → apply as the new override.
Response
Successful Response
Current pension membership state for an employee.
Reflects the latest (highest version) membership history record. Per-employee rate override fields (employee_rate, employer_rate, etc.) are null when the scheme defaults apply; non-null values take precedence over the scheme.
AE worker category at enrolment time: ELIGIBLE_JOBHOLDER (age 22–SPA, earnings ≥ trigger — employer must enrol), NON_ELIGIBLE_JOBHOLDER (outside age/earnings band — can opt in), ENTITLED_WORKER (earnings below lower limit — can join, employer need not contribute), EXCLUDED (not subject to AE). Null if not yet enrolled
ELIGIBLE_JOBHOLDER, NON_ELIGIBLE_JOBHOLDER, ENTITLED_WORKER, EXCLUDED