The Adviser API from Smart Pension — 4 operation(s) for adviser.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/smart-pension-adviser-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Keystone Adviser API
version: v12
description: This is the endpoint description of Keystone API.
servers:
- url: https://api.sandbox.autoenrolment.co.uk
- url: /
tags:
- name: Adviser
paths:
/advisers:
post:
summary: Advisers/Create
tags:
- Adviser
parameters: []
requestBody:
content:
application/json:
example:
name: name
address: 30 Wellington Square, London ZE0 0ZZ
email: name@email.com
title: Mr
forename: forename
surname: surname
telephone: +44 123 4567 890
password: '!1234Qwertyuiop'
signup_start: signup_start_text
signup_finish: signup_finish_text
schema:
type: object
properties:
logo:
type: string
format: binary
name:
type: string
minimum: 2
maximum: 115
address:
type: string
minimum: 2
maximum: 165
signup_start:
type: string
minimum: 2
maximum: 120
signup_finish:
type: string
minimum: 2
maximum: 120
channel:
type: string
agent_number:
type: string
broker_role:
type: string
broker_channel:
type: string
email:
type: string
telephone:
type: string
annuity_option_enabled:
type: boolean
marketing_included:
type: boolean
password:
type: string
title:
type: string
forename:
type: string
surname:
type: string
required:
- email
- telephone
- name
- address
- password
- forename
- surname
responses:
'201':
description: Success
content:
application/json:
example:
intercom_user_id: '8'
intercom_user_id_hash: c08bec7292d6a2a31f37a0a63ef8bfc2bfe2070037edf140833c85b69d94fe2e
id: 8
name: name
type: Adviser
address: 30 Wellington Square, London ZE0 0ZZ
created_at: '2026-08-05T12:57:36.000+01:00'
updated_at: '2026-08-05T12:57:36.000+01:00'
signup_start: signup_start_text
signup_finish: signup_finish_text
agent_number: null
broker_channel: null
broker_role: null
abilities: []
user_id: 10
title: Mr
forename: forename
surname: surname
email: name@email.com
telephone: '+441234567890'
api_key: rtMRHRm1UsETyGkIYyxmRw
authorization_redirect_uri: https://id.host.com/user/callbacks/smartpension?code=m_zP_rzLQYMY5lvzvqkvOfCwyaClZa0P7ZfF-2f3aw8
schema:
$ref: '#/components/schemas/response_adviser'
'422':
description: Invalid parameters
get:
summary: Advisers/List
tags:
- Adviser
security:
- oAuth2:
- customer
parameters:
- name: limit
in: query
schema:
type: integer
required: false
- name: offset
in: query
schema:
type: integer
required: false
- name: sort
in: query
schema:
type: string
required: false
- name: direction
in: query
schema:
type: string
enum:
- ASC
- DESC
required: false
- name: filter
in: query
schema:
type: object
properties:
id:
type: array
items:
type: integer
name:
type: array
items:
type: string
address:
type: array
items:
type: string
required: false
style: deepObject
- name: operator
in: query
schema:
type: string
enum:
- or
- and
required: false
responses:
'200':
description: Success
content:
application/json:
example:
limit: 50
offset: 0
total: 0
links:
- rel: self
title: self
href: http://api.host.com/advisers
- rel: first
title: first
href: http://api.host.com/advisers?offset=0&limit=50
- rel: last
title: last
href: http://api.host.com/advisers?offset=0&limit=50
advisers: []
schema:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
advisers:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_adviser'
'401':
description: Unauthorized
/advisers/by_token:
get:
summary: Advisers/GetByToken
tags:
- Adviser
parameters:
- name: referralToken
in: query
required: true
example: referralToken=GwNH76ddiJruUshEQehZ
schema:
type: string
- name: include[]
in: query
schema:
type: array
items:
enum:
- shortcut
required: false
responses:
'200':
description: Success
content:
application/json:
example:
name: super
signup_start: null
signup_finish: null
id: 16
schema:
$ref: '#/components/schemas/response_adviser'
'404':
description: Not Found
/advisers/{id}:
get:
summary: Advisers/Get
tags:
- Adviser
security:
- oAuth2:
- user
parameters:
- name: id
in: path
required: true
example: 17
schema:
type: string
- name: include[]
in: query
schema:
type: array
items:
enum:
- shortcut
required: false
responses:
'200':
description: Success
content:
application/json:
example:
intercom_user_id: '17'
intercom_user_id_hash: 1daae4d985f0f0f52c9d893ec2e83c4322799a25002849565878a66987a4beca
id: 17
name: super
type: Adviser
address: address
created_at: '2026-08-05T12:57:40.000+01:00'
updated_at: '2026-08-05T12:57:40.000+01:00'
signup_start: null
signup_finish: null
agent_number: c389b17
broker_channel: null
broker_role: null
abilities: []
schema:
$ref: '#/components/schemas/response_adviser'
'404':
description: Not Found
put:
summary: Advisers/Update
tags:
- Adviser
security:
- oAuth2:
- user
parameters:
- name: id
in: path
required: true
example: 29
schema:
type: string
requestBody:
content:
application/json:
examples:
success:
value:
email: james@test.com
name: James
address: 30 Wellington Square, London ZE0 0ZZ
adviser:
name: new name
signup_start: signup_start_text
signup_finish: signup_finish_text
invalid_parameters:
value:
email: james@test.com
name: James
address: 30 Wellington Square, London ZE0 0ZZ
adviser:
name: null
schema:
type: object
properties:
logo:
type: string
format: binary
name:
type: string
minimum: 2
maximum: 115
address:
type: string
minimum: 2
maximum: 165
signup_start:
type: string
minimum: 2
maximum: 120
signup_finish:
type: string
minimum: 2
maximum: 120
channel:
type: string
agent_number:
type: string
broker_role:
type: string
broker_channel:
type: string
email:
type: string
telephone:
type: string
annuity_option_enabled:
type: boolean
responses:
'204':
description: Success
'404':
description: Not Found
'422':
description: Invalid parameters
content:
application/json:
example:
errors:
- code: 554
title: Not Enough Characters for name provided.
detail: You need to enter a name with a minimum of 2 characters.
meta:
count: 2
source:
pointer: /data/attributes/name
- code: 556
title: Adviser name is required.
detail: You need to include a name for this adviser account; this is the name that clients of this adviser will see.
meta: {}
source:
pointer: /data/attributes/name
patch:
summary: Advisers/Update
tags:
- Adviser
security:
- oAuth2:
- user
parameters:
- name: id
in: path
required: true
example: 32
schema:
type: string
requestBody:
content:
application/json:
examples:
success:
value:
email: james@test.com
name: James
address: 30 Wellington Square, London ZE0 0ZZ
adviser:
name: new name
signup_start: signup_start_text
signup_finish: signup_finish_text
invalid_parameters:
value:
email: james@test.com
name: James
address: 30 Wellington Square, London ZE0 0ZZ
adviser:
name: null
schema:
type: object
properties:
logo:
type: string
format: binary
name:
type: string
minimum: 2
maximum: 115
address:
type: string
minimum: 2
maximum: 165
signup_start:
type: string
minimum: 2
maximum: 120
signup_finish:
type: string
minimum: 2
maximum: 120
channel:
type: string
agent_number:
type: string
broker_role:
type: string
broker_channel:
type: string
email:
type: string
telephone:
type: string
annuity_option_enabled:
type: boolean
responses:
'204':
description: Success
'404':
description: Not Found
'422':
description: Invalid parameters
content:
application/json:
example:
errors:
- code: 554
title: Not Enough Characters for name provided.
detail: You need to enter a name with a minimum of 2 characters.
meta:
count: 2
source:
pointer: /data/attributes/name
- code: 556
title: Adviser name is required.
detail: You need to include a name for this adviser account; this is the name that clients of this adviser will see.
meta: {}
source:
pointer: /data/attributes/name
/advisers/{id}/managed-employees:
post:
summary: Advisers/ManagedEmployees
tags:
- Adviser
security:
- oAuth2:
- user
parameters:
- name: id
in: path
description: Adviser ID
required: true
example: 23
schema:
type: string
requestBody:
content:
application/json:
examples:
success:
value:
employee_id: 4
example:
employee_id: 5
schema:
type: object
properties:
employee_id:
type: integer
description: Employee ID
responses:
'204':
description: Success
'403':
description: Forbidden - Current adviser is not a SuperAdviser
'404':
description: Not Found - Adviser does not exist
components:
schemas:
response_adviser_import:
type: object
properties:
id:
type: integer
status_code:
type:
- integer
- 'null'
state:
type: string
response_errors:
type:
- array
- 'null'
items: {}
file_url:
type:
- string
- 'null'
file_file_name:
type:
- string
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
type:
type:
- string
- 'null'
metadata:
type:
- object
- 'null'
success_row_count:
type:
- integer
- 'null'
fail_row_count:
type:
- integer
- 'null'
adviser_id:
type: integer
links:
type: array
items:
$ref: '#/components/schemas/link'
adviser:
$ref: '#/components/schemas/response_adviser'
response_adviser_shortcut:
type: object
properties:
id:
type: integer
token:
type:
- string
- 'null'
destination_url:
type:
- string
- 'null'
short_url:
type:
- string
- 'null'
response_customer_shortcut:
type: object
properties:
id:
type: integer
token:
type:
- string
- 'null'
destination_url:
type:
- string
- 'null'
short_url:
type:
- string
- 'null'
response_enrolment:
type: object
properties:
id:
type: integer
company_id:
type: integer
event_on:
type: string
format: date
next_re_declaration_of_compliance_deadline_on:
type:
- string
- 'null'
format: date
next_re_enrolment_window_starts_on:
type:
- string
- 'null'
format: date
next_re_enrolment_window_ends_on:
type:
- string
- 'null'
format: date
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
links:
type: array
items:
$ref: '#/components/schemas/link'
company:
$ref: '#/components/schemas/response_company'
link:
type: object
properties:
rel:
type: string
title:
type: string
href:
type: string
response_company_import:
type: object
properties:
id:
type: integer
status_code:
type:
- integer
- 'null'
state:
type: string
response_errors:
type:
- array
- 'null'
items: {}
file_url:
type:
- string
- 'null'
file_file_name:
type:
- string
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
type:
type:
- string
- 'null'
metadata:
type:
- object
- 'null'
success_row_count:
type:
- integer
- 'null'
fail_row_count:
type:
- integer
- 'null'
company_id:
type: integer
links:
type: array
items:
$ref: '#/components/schemas/link'
company:
$ref: '#/components/schemas/response_company'
response_company_automation:
type: object
properties:
id:
type: integer
letter:
type: boolean
company_id:
type: integer
postponement_period:
type:
- string
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
links:
type: array
items:
$ref: '#/components/schemas/link'
response_employment_statuses:
type: object
properties:
employment_statuses:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_employment_status'
response_salary:
type: object
properties:
annual_earnings_1:
type:
- number
- 'null'
format: float
annual_earnings_2:
type:
- number
- 'null'
format: float
created_at:
type: string
format: date-time
effective_on:
type: string
format: date
employee_id:
type: integer
id:
type: integer
updated_at:
type: string
format: date-time
employee:
$ref: '#/components/schemas/response_employee'
response_portfolio:
type: object
properties:
id:
type: integer
custom:
type: boolean
starts_on:
type: string
format: date
ends_on:
type:
- string
- 'null'
format: date
money_in:
type:
- boolean
- 'null'
portfolio_composed_by_a_tdf:
type:
- boolean
- 'null'
subaccount_uuid:
type:
- string
- 'null'
subaccount_name:
type:
- string
- 'null'
subaccount_group:
type:
- string
- 'null'
fund_splits:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
fund_splits:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_fund_split'
response_ultimate_beneficial_owner_configuration:
type: object
properties:
id:
type: integer
company_id:
type: integer
exempt:
type: boolean
exemption_reason:
type:
- string
- 'null'
natural_person_ubo:
type: boolean
links:
type: array
items:
$ref: '#/components/schemas/link'
response_employee_plan_participation:
type: object
properties:
id:
type: integer
in_waiting_period:
type:
- boolean
- 'null'
next_state:
type:
- string
- 'null'
updated_at:
type: string
format: date-time
state:
type: string
response_employee_configuration:
type: object
properties:
benefits_out_suspended:
type: boolean
disabled_switching:
type:
- boolean
- 'null'
enable_auto_increase_percentage:
type: boolean
gone_away:
type: boolean
id:
type: integer
investments_locked:
type: boolean
valuation_under_review:
type:
- boolean
- 'null'
preferred_currency:
type:
- string
- 'null'
preferred_locale:
type:
- string
- 'null'
blocked_rejoin:
type: boolean
response_customer:
type: object
properties:
intercom_user_id:
type:
- string
- 'null'
intercom_user_id_hash:
type:
- string
- 'null'
id:
type: integer
email:
type:
- string
- 'null'
reset_password_sent_at:
type:
- string
- 'null'
format: date-time
remember_created_at:
type:
- string
- 'null'
format: date-time
last_sign_in_at:
type:
- string
- 'null'
format: date-time
slug:
type:
- string
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
gauth_enabled:
type: boolean
gauth_tmp:
type:
- string
- 'null'
forename:
type:
- string
- 'null'
surname:
type:
- string
- 'null'
title:
type:
- string
- 'null'
authentication_token:
type:
- string
- 'null'
date_of_birth:
type:
- string
- 'null'
format: date
line2:
type:
- string
- 'null'
city:
type:
- string
- 'null'
county:
type:
- string
- 'null'
building_name:
type:
- string
- 'null'
postcode:
type:
- string
- 'null'
line1:
type:
- string
- 'null'
building_number:
type:
- string
- 'null'
telephone:
type:
- string
- 'null'
alternative_telephone:
type:
- string
- 'null'
referee_id:
type:
- integer
- 'null'
referee_type:
type:
- string
- 'null'
referral_state:
type: string
referral_clicks:
type:
- integer
- 'null'
referral_reward_name:
type:
- string
- 'null'
authentication_token_generated_at:
type:
- string
- 'null'
format: date-time
gender:
type:
- string
- 'null'
role:
type:
- string
- 'null'
middlename:
type:
- string
- 'null'
envelope_state:
type: string
enforce_password:
type:
- boolean
- 'null'
company_id:
type:
- integer
- 'null'
country_code:
type:
- string
- 'null'
uuid:
type: string
preferred_locale:
type:
- string
- 'null'
smart_analytics_access_permitted:
type:
- boolean
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
company:
$ref: '#/components/schemas/response_company'
employee:
$ref: '#/components/schemas/response_employee'
shortcut:
$ref: '#/components/schemas/response_customer_shortcut'
marketing_preference:
$ref: '#/components/schemas/response_marketing_preference'
response_company:
type: object
properties:
id:
type: integer
name:
type:
- string
- 'null'
slug:
type:
- string
- 'null'
registration_number:
type:
- string
- 'null'
tax_office_number:
type:
- string
- 'null'
tax_office_employer_reference:
type:
- string
- 'null'
legal_structure:
type:
- string
- 'null'
welcome_letters_reminder_sent_at:
type:
- string
- 'null'
format: date-time
pension_regulator_letter_code:
type:
- string
- 'null'
trading_address1:
type:
- string
- 'null'
trading_address2:
type:
- string
- 'null'
trading_address3:
type:
- string
- 'null'
trading_address_postcode:
type:
- string
- 'null'
trading_address_country:
type:
- string
- 'null'
reg_address1:
type:
- string
- 'null'
reg_address2:
type:
- string
- 'null'
reg_address3:
type:
- string
- 'null'
reg_address4:
type:
- string
- 'null'
reg_address_postcode:
type:
- string
- 'null'
reg_address_country:
type:
- string
- 'null'
pensionable_earning_type:
type: string
default_percentage:
type:
- number
- 'null'
format: float
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
state:
type: string
employee_can_change_contribution:
type: boolean
uuid:
type: string
layout_configuration_id:
type:
- integer
- 'null'
relief_at_source_active:
type:
- boolean
- 'null'
only_employer_manages_membership:
type: boolean
national_insurance_saving_share:
type:
- number
- 'null'
format: float
tax_relief_basis_type:
type:
- string
- 'null'
tax_relief_fallback_type:
type:
- string
- 'null'
direct_debit_optional:
type: boolean
skip_contribution_validations:
type: boolean
self_certification_started_at:
type:
- string
- 'null'
format: date-time
customers:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
customers:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_customer'
payments:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
payments:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_payment'
employees:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
employees:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_employee'
enrolments:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
enrolments:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_enrolment'
imports:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
data:
type:
- ar
# --- truncated at 32 KB (81 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/smart-pension/refs/heads/main/openapi/smart-pension-adviser-api-openapi.yml