Get pension scheme
Get a specific workplace pension scheme by its stable handle ID.
Authorizations
Get token from Auth0 and paste it here
Response
Successful Response
Organisation's pension scheme configuration.
scheme_id is the stable handle identifier — use it in {scheme_id} path segments
and in membership scheme_id fields. valid_from/valid_to describe the validity
window of this particular configuration version.
Date from which this configuration version is effective
Stable handle UUID for the scheme; does not change when configuration is updated via PATCH. Use this in URL path segments and membership scheme_id fields
Whether this is the organisation's default scheme; only one scheme per org can be default. New eligible employees are auto-enrolled into the default scheme
Display name for the scheme
Pension provider (NEST = National Employment Savings Trust, OTHER = any other provider)
NEST, OTHER Tax treatment method: NET_PAY (deducted pre-tax), RELIEF_AT_SOURCE (deducted post-tax, provider claims tax relief from HMRC), SALARY_SACRIFICE (employee gives up salary; saves NIC for both parties)
NET_PAY, RELIEF_AT_SOURCE, SALARY_SACRIFICE Earnings base for contribution calculation: QUALIFYING_EARNINGS (band £6,240–£50,270/year, 2025-26), PENSIONABLE_PAY (full pay, no lower threshold)
QUALIFYING_EARNINGS, PENSIONABLE_PAY Employee contribution rate as a decimal (e.g. 0.05 = 5%); statutory minimum is 5% on qualifying earnings
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Employer contribution rate as a decimal (e.g. 0.03 = 3%); statutory minimum is 3% on qualifying earnings
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Maximum employee contribution per pay period as an absolute amount; null = no cap
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Maximum employer contribution per pay period as an absolute amount; null = no cap
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Months to postpone auto-enrolment for newly eligible jobholders (0 = enrol immediately, max 3)
Whether the employer voluntarily contributes for Entitled Workers (earnings below £6,240/year) who choose to join the scheme
Employer's chosen cyclical re-enrolment date (every ~3 years); opted-out employees are re-enrolled on this date
Earliest permissible re-enrolment date (3 months before the staging anniversary)
Latest permissible re-enrolment date (3 months after the staging anniversary)
Wage type code used for the pension deduction line item on payslip; must be PENSION category. NET_PAY/RAS use UK-P-001 or UK-P-002; SALARY_SACRIFICE requires UK-P-003
Timestamp when this configuration version was created
Date on which this version expires (exclusive); null means this is the current active version. Populated automatically when a newer version is created via PATCH
User identifier (from JWT sub) who created this version; null if created by the system