The Summaries API from Smart Pension — 4 operation(s) for summaries.
openapi: 3.2.0
info:
title: Keystone Summaries API
version: v12
description: This is the endpoint description of Keystone API.
servers:
- url: https://api.sandbox.autoenrolment.co.uk
- url: /
tags:
- name: Summaries
paths:
/companies/{company_id}/contributions/summary/payable:
get:
summary: SummariesPayable/Get
tags:
- Summaries
security:
- oAuth2:
- customer
parameters:
- name: company_id
in: path
required: true
example: 147
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
example:
employer_within_opt_out_window: 1221
employee_within_opt_out_window: 2442
voluntary_within_opt_out_window: 3663
total_within_opt_out_window: 7326
employer_after_opt_out_window: 111
employee_after_opt_out_window: 222
voluntary_after_opt_out_window: 333
total_after_opt_out_window: 666
schema:
$ref: '#/components/schemas/response_summary_payable_contributions'
'404':
description: Not Found
/companies/{company_id}/contributions/summary:
get:
summary: Summaries/Get
tags:
- Summaries
security:
- oAuth2:
- customer
parameters:
- name: company_id
in: path
required: true
example: 192
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
example:
company_amount: 8
employee_amount: 12
voluntary_amount: 0
total_amount: 20
contribution_amounts_totals:
employer: 8
employee: 12
other_avc: 0
life_cover: 0
payable_company_amount: 8
payable_employee_amount: 12
payable_voluntary_amount: 0
payable_total_amount: 20
non_payable_company_amount: 0
non_payable_employee_amount: 0
non_payable_voluntary_amount: 0
non_payable_total_amount: 0
non_payable_within_opt_out_window_total_amount: 0
non_payable_ends_on_after_cut_off_total_amount: 0
non_payable_company_within_opt_out_window_amount: 0
non_payable_company_ends_on_after_cut_off_amount: 0
non_payable_employee_within_opt_out_window_amount: 0
non_payable_employee_ends_on_after_cut_off_amount: 0
non_payable_voluntary_within_opt_out_window_amount: 0
non_payable_voluntary_ends_on_after_cut_off_amount: 0
schema:
$ref: '#/components/schemas/response_summary_contributions'
'401':
description: Unauthorized
'404':
description: Not Found
/companies/{company_id}/contributions/summary/totals:
get:
summary: SummariesTotals/Get
tags:
- Summaries
security:
- oAuth2:
- customer
parameters:
- name: company_id
in: path
required: true
example: 198
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
example:
company_amount: 8
employee_amount: 12
voluntary_amount: 0
total_amount: 20
contribution_amounts_totals:
employer: 8
employee: 12
other_avc: 0
life_cover: 0
schema:
$ref: '#/components/schemas/response_summary_totals_contributions'
'401':
description: Unauthorized
'404':
description: Not Found
/companies/{company_id}/employees/{employee_id}/contributions/summary:
get:
summary: Summaries/Get
tags:
- Summaries
security:
- oAuth2:
- user
- customer
parameters:
- name: company_id
in: path
required: true
example: 495
schema:
type: string
- name: employee_id
in: path
required: true
example: 228
schema:
type: string
- 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:
state:
type: array
items:
type: string
assessment:
type: object
properties:
category:
type: string
period_type:
type: array
items:
type: string
starts_on:
type: array
items:
type: string
ends_on:
type: array
items:
type: string
required: false
style: deepObject
example: filter%5Bstate%5D%5B%5D=created&filter%5Bstate%5D%5B%5D=paid
- name: include[]
in: query
schema:
type: array
items:
enum:
- assessment
required: false
- name: operator
in: query
schema:
type: string
enum:
- or
- and
required: false
responses:
'200':
description: Success
content:
application/json:
examples:
With valid params without filtering:
value:
company_amount: 200
employee_amount: 200
voluntary_amount: 0
total_amount: 400
contribution_amounts_totals:
employer: 200
employee: 200
other_avc: 0
life_cover: 0
payable_company_amount: 200
payable_employee_amount: 200
payable_voluntary_amount: 0
payable_total_amount: 400
non_payable_company_amount: 0
non_payable_employee_amount: 0
non_payable_voluntary_amount: 0
non_payable_total_amount: 0
non_payable_within_opt_out_window_total_amount: 0
non_payable_ends_on_after_cut_off_total_amount: 0
non_payable_company_within_opt_out_window_amount: 0
non_payable_company_ends_on_after_cut_off_amount: 0
non_payable_employee_within_opt_out_window_amount: 0
non_payable_employee_ends_on_after_cut_off_amount: 0
non_payable_voluntary_within_opt_out_window_amount: 0
non_payable_voluntary_ends_on_after_cut_off_amount: 0
With filtering by state:
value:
company_amount: 100
employee_amount: 100
voluntary_amount: 0
total_amount: 200
contribution_amounts_totals:
employer: 100
employee: 100
other_avc: 0
life_cover: 0
payable_company_amount: 100
payable_employee_amount: 100
payable_voluntary_amount: 0
payable_total_amount: 200
non_payable_company_amount: 0
non_payable_employee_amount: 0
non_payable_voluntary_amount: 0
non_payable_total_amount: 0
non_payable_within_opt_out_window_total_amount: 0
non_payable_ends_on_after_cut_off_total_amount: 0
non_payable_company_within_opt_out_window_amount: 0
non_payable_company_ends_on_after_cut_off_amount: 0
non_payable_employee_within_opt_out_window_amount: 0
non_payable_employee_ends_on_after_cut_off_amount: 0
non_payable_voluntary_within_opt_out_window_amount: 0
non_payable_voluntary_ends_on_after_cut_off_amount: 0
With filtering by multiple states:
value:
company_amount: 200
employee_amount: 200
voluntary_amount: 0
total_amount: 400
contribution_amounts_totals:
employer: 200
employee: 200
other_avc: 0
life_cover: 0
payable_company_amount: 100
payable_employee_amount: 100
payable_voluntary_amount: 0
payable_total_amount: 200
non_payable_company_amount: 0
non_payable_employee_amount: 0
non_payable_voluntary_amount: 0
non_payable_total_amount: 0
non_payable_within_opt_out_window_total_amount: 0
non_payable_ends_on_after_cut_off_total_amount: 0
non_payable_company_within_opt_out_window_amount: 0
non_payable_company_ends_on_after_cut_off_amount: 0
non_payable_employee_within_opt_out_window_amount: 0
non_payable_employee_ends_on_after_cut_off_amount: 0
non_payable_voluntary_within_opt_out_window_amount: 0
non_payable_voluntary_ends_on_after_cut_off_amount: 0
schema:
$ref: '#/components/schemas/response_contribution'
'404':
description: Not Found
'422':
description: Invalid parameters
content:
application/json:
schema:
$ref: '#/components/schemas/response_contribution'
components:
schemas:
response_band:
type: object
properties:
id:
type: integer
employee_minimum_percentage:
type: number
format: float
employee_maximum_percentage:
type:
- number
- 'null'
format: float
employer_percentage:
type: number
format: float
starts_on:
type: string
format: date
ends_on:
type: string
format: date
range_min:
type:
- integer
- 'null'
range_max:
type:
- integer
- 'null'
default:
type: boolean
response_scheme_contribution_limit:
type: object
properties:
minimum_one_off_contribution_amount:
type: number
format: float
minimum_one_off_contribution_amount_currency:
type: string
maximum_one_off_contribution_amount:
type: number
format: float
maximum_one_off_contribution_amount_currency:
type: string
minimum_recurring_contribution_amount:
type: number
format: float
minimum_recurring_contribution_amount_currency:
type: string
response_adviser:
type: object
properties:
intercom_user_id:
type:
- string
- 'null'
intercom_user_id_hash:
type:
- string
- 'null'
id:
type: integer
name:
type:
- string
- 'null'
type:
type:
- string
- 'null'
address:
type:
- string
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
signup_start:
type:
- string
- 'null'
format: text
signup_finish:
type:
- string
- 'null'
format: text
agent_number:
type:
- string
- 'null'
broker_channel:
type:
- string
- 'null'
broker_role:
type:
- string
- 'null'
abilities:
type:
- array
- 'null'
items: {}
companies:
type: object
properties:
limit:
type:
- integer
- 'null'
offset:
type:
- integer
- 'null'
total:
type:
- integer
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
companies:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_company'
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:
- array
- 'null'
items:
$ref: '#/components/schemas/response_adviser_import'
company_tax_reliefs:
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:
- array
- 'null'
items:
$ref: '#/components/schemas/response_company_tax_relief'
shortcut:
$ref: '#/components/schemas/response_adviser_shortcut'
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_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_know_your_customer_data:
type: object
properties:
id:
type: integer
state:
type: string
reference:
type:
- string
- 'null'
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_adviser_company:
type: object
properties:
id:
type: integer
adviser_id:
type: integer
company_id:
type: integer
preferred_contact_user_id:
type:
- integer
- 'null'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
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_payment:
type: object
properties:
id:
type: integer
state:
type: string
amount:
type:
- number
- 'null'
format: float
description:
type:
- string
- 'null'
invoice_name:
type:
- string
- 'null'
paid_at:
type:
- string
- 'null'
format: date-time
charge_on:
type:
- string
- 'null'
format: date
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
invoice_url:
type:
- string
- 'null'
invoice_details_url:
type:
- string
- 'null'
invoice_details_file_name:
type:
- string
- 'null'
source_of_funds:
type:
- string
- 'null'
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_letter:
type: object
properties:
id:
type: integer
subject:
type:
- string
- 'null'
name:
type:
- string
- 'null'
employee_id:
type:
- integer
- 'null'
read:
type:
- boolean
- 'null'
file_url:
type:
- string
- 'null'
file_file_name:
type:
- string
- 'null'
created_at:
type:
- string
- 'null'
format: date-time
updated_at:
type:
- string
- 'null'
format: date-time
cancelled_at:
type:
- string
- 'null'
format: date-time
created_by_id:
type:
- integer
- 'null'
created_by_type:
type:
- string
- 'null'
send_employee_temporary_password_notification:
type:
- boolean
- 'null'
links:
type: array
items:
$ref: '#/components/schemas/link'
employee:
$ref: '#/components/schemas/response_employee'
response_base_payroll_configuration:
type: object
properties:
id:
type: integer
company_id:
type: integer
description:
type:
- string
- 'null'
frequency:
type: string
name:
type: string
salary_rate:
type: string
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
uuid:
type: string
links:
type: array
items:
$ref: '#/components/schemas/link'
response_company_tax_relief:
type: object
properties:
id:
type: integer
basis_type:
type: string
response_beneficiary:
type: object
properties:
id:
type: integer
title:
type: string
name:
type: string
email:
type:
- string
- 'null'
address:
type: string
postcode:
type:
- string
- 'null'
relation:
type: string
percentage:
type: number
format: float
born_on:
type: string
format: date
type:
type: string
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_provider_scheme_migration:
type: object
properties:
id:
type: integer
state:
type: string
response_benefit_check_result:
type: object
properties:
id:
type: integer
benefit_id:
type: integer
state:
type: string
redirect_url:
type:
- string
- 'null'
has_redirect_url:
type:
- boolean
- 'null'
returned_back_at:
type:
- string
- 'null'
format: date-time
comment:
type:
- string
- 'null'
format: text
automated_checks_available:
type: boolean
response_valuation:
type: object
properties:
id:
type: integer
amount:
type:
- number
- 'null'
format: float
calculated_on:
type: string
format: date
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
response_benefit_group:
type: object
properties:
id:
type: integer
name:
type: string
employee_contribution_holiday_permitted:
type: boolean
company_contribution_holiday_permitted:
type: boolean
band_range_type:
type:
- string
- 'null'
employer_earnings_type:
type: string
employee_earnings_type:
type: string
employer_salary_cap:
type:
- number
- 'null'
format: float
employee_salary_cap:
type:
- number
- 'null'
format: float
voluntary_enrolment:
type: boolean
profit_share_allowed:
type: boolean
contribution_match_type:
type:
- string
- 'null'
stop_contributions_permitted:
type: boolean
national_insurance_saving_share:
type:
- number
- 'null'
format: float
enrolment_type:
type:
- string
- 'null'
bands:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/response_band'
response_scheme_tax_relief:
type: object
properties:
id:
type: integer
basis_type:
type: string
response_scheme_bank_detail:
type: object
properties:
account_number:
type:
- string
- 'null'
bank_name:
type: string
swift_code:
type: string
in_favor_of:
type: string
currency:
type:
- string
- 'null'
exchange_rate:
type:
- number
- 'null'
format: float
response_adviser_shortcut:
type: object
properties:
id:
type: integer
token:
type:
- string
- 'null'
destination_url:
type:
- string
- 'null'
short_url:
type:
- string
- 'null'
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_employee:
type: object
properties:
updatable:
type:
- boolean
- 'null'
id:
type: integer
email:
type:
- string
- 'null'
forename:
type:
- string
- 'null'
surname:
type:
- string
- 'null'
date_of_birth:
type:
- string
- 'null'
format: date
national_insurance_number:
type:
- string
- 'null'
gender:
type: string
telephone:
type:
- string
- 'null'
identity_person_id:
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
- 'null'
format: date-time
updated_at:
type:
- string
- 'null'
format: date-time
confirmation_token:
type:
- string
- 'null'
gauth_enabled:
type:
- boolean
- 'null'
gauth_tmp:
type:
- string
- 'null'
title:
type:
- string
- 'null'
authentication_token:
type:
- string
- 'null'
group_id:
type:
- integer
- 'null'
line2:
type:
- string
- 'null'
city:
type:
- string
- 'null'
region:
type:
- string
- 'null'
postcode:
type:
- string
- 'null'
line1:
type:
- string
- 'null'
works_in_uk:
type: boolean
starts_on:
type:
- string
- 'null'
format: date
authentication_token_generated_at:
type:
- string
- 'null'
format: date-time
company_percentage:
type:
- number
- 'null'
# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/smart-pension/refs/heads/main/openapi/smart-pension-summaries-api-openapi.yml