Record employee opt-out
Records an employee’s decision to opt out of the pension scheme. The membership status is updated to OPTED_OUT and the opt-out date is stored. Contribution refunds (if within the statutory one-month opt-out window) are applied separately in the next payroll run and are not handled here. Returns 409 if the employee is not currently actively enrolled.
Body
Request to record an employee's opt-out from the pension scheme.
PAPER_NOTICE: the employee gave the employer a paper opt-out notice, which NEST contribution schedules report (reason 9); needs an opt_out_reference and a statutory opt-out. PROVIDER: the employee opted out with the provider, which already knows
PAPER_NOTICE, PROVIDER 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