Payslip

If you don't want to use our customisable PDFs for Payslips then you can retrieve the raw data used to create a Payslip.
This is the model you will be provided with for each employee.

Schema

Name / Description Type / Format Example
isClosed
Indicates if the Payrun has been finalised
 boolean true
taxYear string "Year2017" "Year2018" "Year2019" "Year2020" "Year2021" "Year2022" "Year2023" "Year2024" "Year2025"
payPeriod string "Custom" "Monthly" "FourWeekly" "Fortnightly" "Weekly" "Daily"
periodNumber integer int32 0
period
A description of the period that Payslip relates to.
 string "string"
from
The start date of the period this Payslip covers.
 string date "2026-01-30"
to
The end date of the period this Payslip covers.
 string date "2026-01-30"
paymentDate
The date the Employee will be paid on
 string date "2026-01-30"
note
Any note that should appear on the payslip
 string "string"
allowanceNote
Details of remaining allowance to show on payslip
 string "string"
employee Item {Item}
logoUrl
The Logo to include on the payslip
 string "string"
employer Item {Item}
employerAddress Address {Address}
hmrcDetails HmrcDetails {HmrcDetails}
payOptions
This object forms the basis of the Employees payment.
 PayOptions {PayOptions}
employmentDetails EmploymentDetails {EmploymentDetails}
personalDetails PersonalDetails {PersonalDetails}
totals
Used to represent totals for a PayRun or PayRunEntry.
If a value is 0 then it will not be shown in the JSON.
 PayRunTotals {PayRunTotals}
totalsYtd
Used to represent totals for a PayRun or PayRunEntry.
If a value is 0 then it will not be shown in the JSON.
 PayRunTotals {PayRunTotals}
lines
The lines to display on the Payslip
 PayslipLine[] {PayslipLine}
employerNi
The Employer NI Contribution amount
 number double 0.0
employerPensionContribs
The Employer Pension Contribution Amount
 number double 0.0
depts
The employees Department Membership(s) at the time the payrun was finalised
 StringDecimalKeyValuePair[] {StringDecimalKeyValuePair}
umbrellaPayment UmbrellaPayment {UmbrellaPayment}
costCentres
The employees Cost Centre Membership(s) only populated when creating journals
 StringDecimalKeyValuePair[] {StringDecimalKeyValuePair}
employeeRoleAnalysisCategoryCodes
The EmployeeRoleAnalysisCategoryCodes only populated when creating journals
 EmployeeRoleAnalysisCategoryCode[] {EmployeeRoleAnalysisCategoryCode}
employeeCostCentres
The Employee Cost Centre Membership(s) by role only populated when creating journals
 EmployeeCostCentre[] {EmployeeCostCentre}
departmentMemberships
The Employee Department Membership(s) by role only populated when creating journals
 DepartmentMembership[] {DepartmentMembership}
pensionContributionsByRole
The Pension Employer contribution by role only populated when creating journals
 Item[] {Item}
employerPensionContributions
The list of Employer Pension Contribution(s)
 EmployerPensionContribution[] {EmployerPensionContribution}
employeePensionContributions
Dictionary of Pension Contributions(s) Keyed on PensionId containing Employee Pension and AVC Contribution(s) Bfd, AVC indicator and pension rule
 object {object}
originalPayRunPaymentDate
Original PayRun's Payment Date
 string date "2026-01-30"
isSupplementary
Indicates if this payslip is for a supplementary pay run
 boolean true

JSON Example 

{
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "telephone": "string"
}

References

Contained in Models
Contract.RtiAgentResponse
Contract.RtiSubmissionSettingsResponse
Consumed by Operations

- none -

Returned by Operations

- none -

Payslips Get Payslips
Payslips Customise Payslips