---
title: "Searches for employee statuses for the specified company."
method: POST
path: "/v2/companies/{companyId}/employeeStatusSearches"
tags: ["StatusSearches"]
---

# Searches for employee statuses for the specified company.

`POST /v2/companies/{companyId}/employeeStatusSearches`

## Request

- Base URL: `https://api.paylocity.com/api`
- URL: `https://api.paylocity.com/api/v2/companies/{companyId}/employeeStatusSearches`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.paylocity.com/IdentityServer/connect/token` scopes: `WebLinkAPI`

Performs a employee status search for the specified company according to the search parameters passed in the request body.

## Path parameters

- `companyId` string, required

## Request body

- StatusSearchesV2Request
  - `effectiveDateFlag` string
  - `employeeIds` string[], required

## Response `200`

Successfully Retrieved

- StatusSearchesV2Response
  - `employeeId` string
  - `statuses` object[]
    - `adjustedSeniorityDate` string, paylocity-date, nullable: Adjusted seniority date. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
    - `beginCheckDate` string, paylocity-date, nullable: The date of the first check on which the new employee status will appear. This value is only applicable when updating an existing employee. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
    - `changeReason` string, nullable: Employee status change reason. Must match Company setup.<br /> Max length: 15
    - `effectiveDate` string, paylocity-date, nullable: Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
    - `employeeStatus` string, nullable: Employee current work status. Common values are *A* (Active), *L* (Leave of Absence), *T* (Terminated). <br />Max length: 20
    - `hireDate` string, paylocity-date, nullable: Employee hired date. Updates to hire date are not allowed and will be ignored. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.
    - `isEligibleForRehire` boolean, nullable: Indicates if employee eligible for rehire.
    - `recordType` 'Current' | 'Future' | 'History' | 'All': A value indicating whether this status record is currently in use, out of date, or waiting to become active.
    - `reHireDate` string, paylocity-date, nullable: Rehire date if employee is rehired. Updates to re-hire date are not allowed and will be ignored. Common formats are *MM-DD-CCYY, CCYY-MM-DD*.
    - `statusType` string, nullable: The Status Type associated with the Employee Status code. Each Employee Status code for a company is assigned to one of the Status Type values of A (Active), L (Leave of Absence), T (Terminated).
    - `terminationDate` string, paylocity-date, nullable: Employee termination date. Common formats include *MM-DD-CCYY*, *CCYY-MM-DD*.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: The employee does not exist
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-02-08** `e857a8d2bfad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paylocity/apis/paylocity-api/changes/v2/companies/:companyId/employeeStatusSearches/post.md)

---

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