---
title: "Searches for pay rates for the specified company."
method: POST
path: "/v2/companies/{companyId}/employeePayRateSearches"
tags: ["PayRateSearches"]
---

# Searches for pay rates for the specified company.

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

## Request

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

Performs a pay rates search for the specified company according to the search parameters passed in the request body.

## Path parameters

- `companyId` string, required

## Request body

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

## Response `200`

Successfully Retrieved

- PayRateSearchesModelV2
  - `employeeId` string
  - `payRates` object[]
    - `annualSalary` number
    - `baseRate` number
    - `beginCheckDate` string, date-time
    - `defaultHours` number
    - `effectiveDate` string, date-time
    - `isAutoPay` boolean
    - `payFrequency` string
    - `payType` string
    - `ratePer` string
    - `rateType` string
    - `salary` number

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `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/employeePayRateSearches/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)