GuidesRecipesAPI ReferenceChangelog
API Reference

Gets a list of employees by company ID

Summary Description

The GET Employee List by Company ID API endpoint provides a list of up to 20 employees per call from the Paylocity system. Designed for the initial population of user systems with Paylocity's employee data, it supports pagination for easy navigation through results. The 'include' parameter enables selective retrieval of payload elements, while the 'Active Only' filter helps obtain only those employees with an 'Active' Employee Status Type. This makes the endpoint highly flexible and capable of delivering tailored listings to meet specific user requirements.

GET Employee List by Company ID - Use Cases:

  • The 'Get Employee List by Company ID' endpoint empowers API users to fetch a comprehensive list of employees alongside their relevant data. Ideal for initial data loads.

  • The recommended best practice to track employee demographic changes is not through regular polling of this endpoint. Instead, utilize our employee webhooks in conjunction with the 'GET Single Employee by Company and Employee ID' endpoint.

Path Params
string
required

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

Query Params
int32

Number of employees per page.
Default Value: 20
Maximum Value: 20

string

Next token for the page.

string

Comma separated list of data to be included
Allowable Values:
info, position, status, payrate and futurePayrates.

boolean

Filter only active emplooyes.
Allowable Values:
true, false

Headers
boolean

If true all responses are mocked and generated randomly

string

Authorization token. Ex. Bearer ...

Response

Language

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