---
title: "Get Employees by Pay Period"
method: GET
path: "/apiHub/payroll/v1/companies/{companyId}/payPeriods/{payPeriodId}/employees"
tags: ["Pay Schedules"]
---

# Get Employees by Pay Period

`GET /apiHub/payroll/v1/companies/{companyId}/payPeriods/{payPeriodId}/employees`

## Request

- Base URL: `https://dc1demogwext.paylocity.com`
- URL: `https://dc1demogwext.paylocity.com/apiHub/payroll/v1/companies/{companyId}/payPeriods/{payPeriodId}/employees`
- Auth: HTTP bearer

> 🚧 Partner Restricted
> 
> This endpoint is only available to approved partners who have signed a Paylocity Technology Partnership Agreement. If you are not yet a partner and are interested, [please reach out to our team](https://www.paylocity.com/contact/partner-form/) to discuss partnership opportunities.

**Summary Description**

Retrieves all employee Ids associated with a specific Pay period.

## Path parameters

- `companyId` string, required
- `payPeriodId` string, required

## Query parameters

- `limit` integer
- `nextToken` string

## Headers

- `testMode` boolean
- `Authorization` string, required

## Response `200`

OK

- PayPeriodEmployeesV1Response: Response containing the list of employee IDs assigned to a pay period.
  - `employeeIds` string[], nullable: The list of employee IDs assigned to the pay period.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `502`: Bad Gateway

---

[API](https://skmtc.dev/paylocity/apis/pay-details-api.md) - [All operations](https://skmtc.dev/paylocity/apis/pay-details-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/pay-details-api/revisions/8cbe85265888?raw)