# Paylocity API

**Provider:** Paylocity
**Category:** auth
**Base URL:** `https://api.paylocity.com/api`
**Auth:** oauth2 — `Authorization: Bearer <access_token>`
**Rate Limit:** Varies by contract
**Free Tier:** No
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api.paylocity.com/api

## Description

For general questions and support of the API, contact: webservices@paylocity.com
Overview

Paylocity Web Services API is an externally facing RESTful Internet protocol. The Paylocity API uses HTTP verbs and a RESTful endpoint structure. OAuth 2.0 is used as the API Authorization framework. Requ

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.paylocity.com/api/v2/companies/{companyId}/codes/{codeResource}` | Get All Company Codes |
| GET | `https://api.paylocity.com/api/v2/companies/{companyId}/customfields/{category}` | Get All Custom Fields |
| POST | `https://api.paylocity.com/api/v2/companies/{companyId}/employees` | Add new employee |
| GET | `https://api.paylocity.com/api/v2/companies/{companyId}/employees/` | Get all employees |
| GET | `https://api.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}` | Get employee |
| PATCH | `https://api.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}` | Update employee |
| PUT | `https://api.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}/additionalRates` | Add/update additional rates |
| PUT | `https://api.paylocity.com/api/v2/companies/{companyId}/employees/{employeeId}/benefitSetup` | Add/update employee's benefit setup |

## Authentication

OAuth 2.0 — obtain an access token via the authorization flow

```
Authorization: Bearer <access_token>
```

## Sample Request

```bash
curl -X GET 'https://api.paylocity.com/api/v2/companies/{companyId}/codes/{codeResource}' \
  -H 'Authorization: Bearer <access_token>'
```

## Sample Response

```json
{}
```

## Pricing Details

HR and payroll platform. API access included for enterprise customers. Custom pricing based on employee count. No self-serve API plans — contact sales.

---

*Source: [API Map](https://apimap.dev/apis/paylocity/) — CC BY 4.0*