---
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`

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

---

[API](https://skmtc.net/paylocity/apis/paylocity-api.md) · [All operations](https://skmtc.net/paylocity/apis/paylocity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/paylocity-api/revisions/3725901191b8/schema)