API Basics

Authentication
Errors
Filtering
Rate Limits
Webhooks

Assessments API

Assessments Overview
Callback
Order
- Update Assessment orderpatch
Package
Subscription
- Update or create a subscriptionput

Background Check API

Background Check Overview
Client Onboarding
Subscription
Screening Package
Candidate Screening Order
- Updates the Screening Order statuspatch

Company Level Information API

Company Information
- GET a single Company Informationget
Payroll/HR
Job Codes

Document Management API

Documents Overview
Documents

Employee Demographic API

Employees
- Gets a list of employees by company IDget
- Gets a single employee by company and employee IDsget

Partner Onboarding API

Client Onboarding
- Upsert onboarding statusput

Pay Entry API

Pay Entry
- Create New Payroll Batchpost

Pay Setup API

Pay Setup Overview
Deductions
Earnings

Punch Import API

Punch Import Overview
Punch Import Field Mapping
Punch Import
- Post Employee punch datapost

Retirement contributions Api

Retirement contributions
- Gets Retirement Contributionsget

WebLink API

Authentication
Rate Limits
Deduction
Onboarding
- Add Employee to Onboardingpost
Local Tax
Additional Rates
- Add/update additional ratesput
Client Credentials
- Obtain new client secret.post
Company Codes
- Get All Company Codesget
Company-Specific Schema
- Get Company-Specific Open API Documentationget
Custom Fields
- Get All Custom Fieldsget
Direct Deposit
- Get All Direct Depositget
Earnings
Emergency Contacts
- Add/update emergency contactsput
Employee Benefit Setup
- Add/update employee's benefit setupput
Employee Staging
- Add new employee to Web Linkpost
Employee
Local Taxes
Non-Primary State Tax
- Add/update non-primary state taxput
Pay Rate Searches
- Create an employee pay rates searchpost
PayStatements
Primary State Tax
- Add/update primary state taxput
Sensitive Data
- Get sensitive dataget
- Add/update sensitive dataput
Status Searches
- Create an employee statuses searchpost

API Basics

Authentication
Errors
Filtering
Rate Limits
Webhooks

Assessments API

Assessments Overview
Callback
Order
- Update Assessment orderpatch
Package
Subscription
- Update or create a subscriptionput

Background Check API

Background Check Overview
Client Onboarding
Subscription
Screening Package
Candidate Screening Order
- Updates the Screening Order statuspatch

Company Level Information API

Company Information
- GET a single Company Informationget
Payroll/HR
Job Codes

Document Management API

Documents Overview
Documents

Employee Demographic API

Employees
- Gets a list of employees by company IDget
- Gets a single employee by company and employee IDsget

Partner Onboarding API

Client Onboarding
- Upsert onboarding statusput

Pay Entry API

Pay Entry
- Create New Payroll Batchpost

Pay Setup API

Pay Setup Overview
Deductions
Earnings

Punch Import API

Punch Import Overview
Punch Import Field Mapping
Punch Import
- Post Employee punch datapost

Retirement contributions Api

Retirement contributions
- Gets Retirement Contributionsget

WebLink API

Authentication
Rate Limits
Deduction
Onboarding
- Add Employee to Onboardingpost
Local Tax
Additional Rates
- Add/update additional ratesput
Client Credentials
- Obtain new client secret.post
Company Codes
- Get All Company Codesget
Company-Specific Schema
- Get Company-Specific Open API Documentationget
Custom Fields
- Get All Custom Fieldsget
Direct Deposit
- Get All Direct Depositget
Earnings
Emergency Contacts
- Add/update emergency contactsput
Employee Benefit Setup
- Add/update employee's benefit setupput
Employee Staging
- Add new employee to Web Linkpost
Employee
Local Taxes
Non-Primary State Tax
- Add/update non-primary state taxput
Pay Rate Searches
- Create an employee pay rates searchpost
PayStatements
Primary State Tax
- Add/update primary state taxput
Sensitive Data
- Get sensitive dataget
- Add/update sensitive dataput
Status Searches
- Create an employee statuses searchpost

Returns screening packages

get https://dc1demogwext.paylocity.com/compliance/v1/companies/{companyId}/backgroundCheck/screeningPackages

🚧
Partner Restricted
All background check API endpoints are restricted to background check providers that have signed a Paylocity technology partnership agreement. Please reach out to Techpartnerships@paylocity.com if you would like to discuss partnership opportunities.

Summary Description

Returns the screening packages for the companyId

Use Cases

Partner needs to confirm that package information with Paylocity is correct and calls for the package information for a specific company ID

Path Params

companyId

string

required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.
Allowable Values:
9 char max

Headers

testMode

boolean

If true all responses are mocked and generated randomly

Authorization

string

required

Authorization token. Ex. Bearer ...

Responses

Response body

object

count

int32

Gets the count of items in the Values list.

values

array of objects | null

A list of items.

values

object

isActive

boolean

A Boolean value indicating if the package is active.
Allowable Values:
true, false

packageSummary

string | null

A detailed description of the background check package and what is included in the package.
Allowable Values:
250 char max

packageName

string | null

The name of the specific background check package that the users will see.
Allowable Values:
250 char max

services

array of objects | null

An array of objects representing the underlying services that are included in the background check package.

services

object

serviceName

string | null

The name of the specific service within a background check package that the users will see.
Allowable Values:
50 char max

serviceSummary

string | null

A detailed description of the underlying service in a package.
Allowable Values:
250 char max

price

object

An object representing the price of the package.

billingCode

string | null

Billing code created by a client that can be associated with an order (optional).

packageId

string | null

The Id of the Screening Package.

createdAt

string | null

The date when the Screening Package was created.

updatedAt

string | null

The date when the Screening Package was updated.

partnerName

string | null

Related Partner name.

Response body

object

correlationId

string | null

A unique identifier used for tracing and correlation purposes.

value

object

code

string | null

Error code associated with the error.

message

string | null

Descriptive message detailing the error.

401

Unauthorized

Response body

object

correlationId

string | null

A unique identifier used for tracing and correlation purposes.

value

object

code

string | null

Error code associated with the error.

message

string | null

Descriptive message detailing the error.

Updated 11 months ago

Screening Package

Bulk Upsert

Did this page help you?

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://dc1demogwext.paylocity.com/compliance/v1/companies/companyId/backgroundCheck/screeningPackages \
3
     --header 'accept: application/json'


xxxxxxxxxx
25
 
1
{
2
  "count": 0,
3
  "values": [
4
    {
5
      "isActive": true,
6
      "packageSummary": "string",
7
      "packageName": "string",
8
      "services": [
9
        {
10
          "serviceName": "string",
11
          "serviceSummary": "string"
12
        }
13
      ],
14
      "price": {
15
        "value": 0,
16
        "currency": "string"
17
      },
18
      "billingCode": "string",
19
      "packageId": "string",
20
      "createdAt": "string",
21
      "updatedAt": "string",
22
      "partnerName": "string"
23
    }
24
  ]
25
}

Updated 11 months ago

Screening Package

Bulk Upsert

Did this page help you?

API Basics
Authentication
Errors
Filtering
Rate Limits
Webhooks
Future Dated Changes
Time Off Approval Webhooks
Payroll Processed Webhooks
Termination Webhooks
Employee Change Webhooks
New Hire Webhooks

Assessments API
Assessments Overview
Callback
Delete callbackdelete
Add or update callbackput
Get callbackget
Order
Update Assessment orderpatch
Package
Get Assessment packagesget
Insert or update Assessment packagesput
Delete Assessment packagedelete
Insert or update Assessment packageput
Subscription
Update or create a subscriptionput

Background Check API
Background Check Overview
Client Onboarding
Updates billing code statuspatch
Delete billing codedelete
Add billing codespost
Upsert onboarding statuspost
Subscription
Deletes the webhookdelete
Register the webhook URL for the subscription of new CandidateScreeningOrderpost
Returns the webhook for the subscription of a new candidate screening orderget
Screening Package
Deletes screening packagedelete
Upserts screening packagepost
Bulk Upsertpost
Returns screening packagesget
Candidate Screening Order
Updates the Screening Order statuspatch

Company Level Information API
Company Information
GET a single Company Informationget
Payroll/HR
GET a List of Pay Grades by Company IDget
GET a List of Position Codes by Company IDget
GET a List of Workers Compensation Codes by Company IDget
GET a list of Tax Codes by Company IDget
GET Pay Frequency Code by list by Company IDget
GET a list of Deduction Codes by Company IDget
GET a List of Earning Codes by Company IDget
GET a list of Cost Centers by Company IDget
GET a list of Rate Codes by Company IDget
GET a list of Work Locations by Company IDget
Job Codes
Filtering Job Codes
Delete a single Job Codedelete
Update a single Job Codeput
GET a single Job Codeget
Create a single Job Codepost
GET a list of Job Codes by Company IDget

Document Management API
Documents Overview
Documents
Retrieve a document download URLpost
Get a list of documents filtered by employee for a companyget
Get a list of documents for a companyget

Employee Demographic API
Employees
Gets a single employee by company and employee IDsget
Gets a list of employees by company IDget

Partner Onboarding API
Client Onboarding
Upsert onboarding statusput

Pay Entry API
Pay Entry
Create New Payroll Batchpost

Pay Setup API
Pay Setup Overview
Deductions
Filtering Deductions
DELETE Recurring Deduction Code on the Employee Recorddelete
Update Recurring Deduction Details for a specific past/present/future deductionput
GET Recurring Deduction Details for a specific past/present/future deductionget
GET Recurring Deduction Detailget
Create new Recurring Employee Deductionpost
GET Employee Deduction Listget
Earnings
Filtering Earnings
DELETE Recurring Earning Code on the Employee Recorddelete
Update Recurring Earning Details for a specific past/present/future earningput
GET Recurring Earning Details for a specific past/present/future earningget
GET Recurring Earning Detailget
Create new Recurring Employee Earningpost
GET Employee Earnings Listget

Punch Import API
Punch Import Overview
Punch Import Field Mapping
Punch Import
Post Employee punch datapost

Retirement contributions Api
Retirement contributions
Gets Retirement Contributionsget

WebLink API
Authentication
Rate Limits
Deduction
Get Deduction for Deduction Codeget
Get All Deductionsget
Delete deduction for deduction code / start datedelete
Add / Update Deductionpost
Onboarding
Add Employee to Onboardingpost
Local Tax
Add Local Taxpost
Get All Local Taxesget
Delete Local Tax for Tax Codedelete
Update Local Taxput
Get Local Tax for Tax Codeget
Additional Rates
Add/update additional ratesput
Client Credentials
Obtain new client secret.post
Company Codes
Get All Company Codesget
Company-Specific Schema
Get Company-Specific Open API Documentationget
Custom Fields
Get All Custom Fieldsget
Direct Deposit
Get All Direct Depositget
Earnings
Get Earnings by Earning Codeget
Delete Earning by Earning Code and Start Datedelete
Get Earning by Earning Code and Start Dateget
Add/Update Earningput
Get All Earningsget
Emergency Contacts
Add/update emergency contactsput
Employee Benefit Setup
Add/update employee's benefit setupput
Employee Staging
Add new employee to Web Linkpost
Employee
Update employeepatch
Get employeeget
Add new employeepost
Get all employeesget
Local Taxes
Delete local tax by tax codedelete
Get local taxes by tax codeget
Add new local taxpost
Get all local taxesget
Non-Primary State Tax
Add/update non-primary state taxput
Pay Rate Searches
Create an employee pay rates searchpost
PayStatements
Get employee pay statement summary data for the specified year.get
Get employee pay statement summary data for the specified year and check date.get
Get employee pay statement details data for the specified year.get
Get employee pay statement details data for the specified year and check date.get
Primary State Tax
Add/update primary state taxput
Sensitive Data
Add/update sensitive dataput
Get sensitive dataget
Status Searches
Create an employee statuses searchpost

API Basics
Authentication
Errors
Filtering
Rate Limits
Webhooks
Future Dated Changes
Time Off Approval Webhooks
Payroll Processed Webhooks
Termination Webhooks
Employee Change Webhooks
New Hire Webhooks

Assessments API
Assessments Overview
Callback
Delete callbackdelete
Add or update callbackput
Get callbackget
Order
Update Assessment orderpatch
Package
Get Assessment packagesget
Insert or update Assessment packagesput
Delete Assessment packagedelete
Insert or update Assessment packageput
Subscription
Update or create a subscriptionput

Background Check API
Background Check Overview
Client Onboarding
Updates billing code statuspatch
Delete billing codedelete
Add billing codespost
Upsert onboarding statuspost
Subscription
Deletes the webhookdelete
Register the webhook URL for the subscription of new CandidateScreeningOrderpost
Returns the webhook for the subscription of a new candidate screening orderget
Screening Package
Deletes screening packagedelete
Upserts screening packagepost
Bulk Upsertpost
Returns screening packagesget
Candidate Screening Order
Updates the Screening Order statuspatch

Company Level Information API
Company Information
GET a single Company Informationget
Payroll/HR
GET a List of Pay Grades by Company IDget
GET a List of Position Codes by Company IDget
GET a List of Workers Compensation Codes by Company IDget
GET a list of Tax Codes by Company IDget
GET Pay Frequency Code by list by Company IDget
GET a list of Deduction Codes by Company IDget
GET a List of Earning Codes by Company IDget
GET a list of Cost Centers by Company IDget
GET a list of Rate Codes by Company IDget
GET a list of Work Locations by Company IDget
Job Codes
Filtering Job Codes
Delete a single Job Codedelete
Update a single Job Codeput
GET a single Job Codeget
Create a single Job Codepost
GET a list of Job Codes by Company IDget

Document Management API
Documents Overview
Documents
Retrieve a document download URLpost
Get a list of documents filtered by employee for a companyget
Get a list of documents for a companyget

Employee Demographic API
Employees
Gets a single employee by company and employee IDsget
Gets a list of employees by company IDget

Partner Onboarding API
Client Onboarding
Upsert onboarding statusput

Pay Entry API
Pay Entry
Create New Payroll Batchpost

Pay Setup API
Pay Setup Overview
Deductions
Filtering Deductions
DELETE Recurring Deduction Code on the Employee Recorddelete
Update Recurring Deduction Details for a specific past/present/future deductionput
GET Recurring Deduction Details for a specific past/present/future deductionget
GET Recurring Deduction Detailget
Create new Recurring Employee Deductionpost
GET Employee Deduction Listget
Earnings
Filtering Earnings
DELETE Recurring Earning Code on the Employee Recorddelete
Update Recurring Earning Details for a specific past/present/future earningput
GET Recurring Earning Details for a specific past/present/future earningget
GET Recurring Earning Detailget
Create new Recurring Employee Earningpost
GET Employee Earnings Listget

Punch Import API
Punch Import Overview
Punch Import Field Mapping
Punch Import
Post Employee punch datapost

Retirement contributions Api
Retirement contributions
Gets Retirement Contributionsget

WebLink API
Authentication
Rate Limits
Deduction
Get Deduction for Deduction Codeget
Get All Deductionsget
Delete deduction for deduction code / start datedelete
Add / Update Deductionpost
Onboarding
Add Employee to Onboardingpost
Local Tax
Add Local Taxpost
Get All Local Taxesget
Delete Local Tax for Tax Codedelete
Update Local Taxput
Get Local Tax for Tax Codeget
Additional Rates
Add/update additional ratesput
Client Credentials
Obtain new client secret.post
Company Codes
Get All Company Codesget
Company-Specific Schema
Get Company-Specific Open API Documentationget
Custom Fields
Get All Custom Fieldsget
Direct Deposit
Get All Direct Depositget
Earnings
Get Earnings by Earning Codeget
Delete Earning by Earning Code and Start Datedelete
Get Earning by Earning Code and Start Dateget
Add/Update Earningput
Get All Earningsget
Emergency Contacts
Add/update emergency contactsput
Employee Benefit Setup
Add/update employee's benefit setupput
Employee Staging
Add new employee to Web Linkpost
Employee
Update employeepatch
Get employeeget
Add new employeepost
Get all employeesget
Local Taxes
Delete local tax by tax codedelete
Get local taxes by tax codeget
Add new local taxpost
Get all local taxesget
Non-Primary State Tax
Add/update non-primary state taxput
Pay Rate Searches
Create an employee pay rates searchpost
PayStatements
Get employee pay statement summary data for the specified year.get
Get employee pay statement summary data for the specified year and check date.get
Get employee pay statement details data for the specified year.get
Get employee pay statement details data for the specified year and check date.get
Primary State Tax
Add/update primary state taxput
Sensitive Data
Add/update sensitive dataput
Get sensitive dataget
Status Searches
Create an employee statuses searchpost

200Returns the screening packages

400Bad Request Error - Returns the details of the error

415Unsupported Media Type - Returns the details of the error