GuidesRecipesAPI ReferenceChangelog
API Reference

Gets Retirement Contributions

Summary Description

The GET Retirement Contributions endpoint provides deferrals, loan payments, employer match. The endpoint also provides employee compensation, plan compensation and YTD amounts for each money source. For smooth data transmission, it's essential to configure your payroll code groups within the Payroll/HR system. This configuration must be done prior to extracting any data via the API. API users can call the API using either the payroll process date or the payroll check date. When the API is called, API users will provide three key pieces of information: the Paylocity Company ID, the Plan ID, and the Check Date they wish to retrieve data for. This information is provided to the API user when using our Retirement Webhook solution.

The Paylocity Retirement Platform use cases:

  • The Retirement Contributions endpoint serves to extract data related to employee retirement plan contributions and compensation.
  • To use the Retirement Contributions Endpoint, an API user must provide the Paylocity Company ID, the Plan ID, and the Check Date for which they need data. The returned response will include all employees with applicable payroll information.
  • Clients must first set up their Paylocity Payroll Code Groups before they can utilize this API endpoint.
  • The optimal solution recommended by Paylocity involves using our Retirement Web Hook. This Web Hook equips the API user with necessary details such as the Paylocity Company ID, the Plan ID, and the Check Date to call the API. This data can then be used to retrieve the most recent employee retirement information.
Path Params
string
required

The Paylocity Company ID. This is the unique value provided by Paylocity to each specific Payroll Entity

string
required

The Plan ID from the retirement plan provider. This would match the value provided by the record keeper to the customer

date-time
required

The Check Date from the Paylocity Payroll Calendar
Allowable Values:
Format: yyyy-MM-dd

Query Params
int32

The number of contribution statements to return.
Default Value:
10
Maximum Value:
100

int32

The number of contribution statements to skip, if requesting subsequent pages.
Allowable Values:
Any integer

string

A comma separated list of fields to use for sorting.
Fields can be sorted descending by appending :desc to the field name.

Allowable Values:
employeeId, beginDate, endDate, grossEarnings, hours

string

A filter to use to limit results to a specific employee.

string

A filter used to limit results to a specific payroll process, commonly used when pulling data due to a web hook callback after a payroll is processed.

string

A Boolean value that, when set to "true", returns mock data.

Headers
string
required
Defaults to Bearer JWT_GOES_HERE

Authorization token. Ex. Bearer ...

Responses

401

Unauthorized

500

Server Error

Language
Credentials

Copyright © 2025 Paylocity. All Rights Reserved. Privacy Center | Terms and Conditions | Accessibility