# Paycor Public API API

> Paycor Public API API on Apizie: 114 endpoints (Get a list of ATS Account jobs for ATS Account Id, Get an ATS Account Job for ATS Account Id, Get a list of ATS Accounts for Legal Entity, Either Home Phone, Work Phone or Mobile Phone must be specified Data Access: Create Emergency Contact, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/dev-tools:paycor/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:paycor`
- Category: Dev Tools
- Status: byok
- Source: https://paycor.com
- Page: https://www.apizie.tech/api/dev-tools/paycor
- OpenAPI: https://www.apizie.tech/api/dev-tools/paycor/openapi.json

Welcome to Paycor's Public API! This document is a reference for the APIs Paycor has available, and acts as a complement to the "Guides" section. # Getting Started To learn more about getting started with Paycor's…

## Endpoints

### Get a list of ATS Account jobs for ATS Account Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/applicant-tracking-system-get-account-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Paycor Legal Entity ID of the legal entity for which you want to get the ATS account jobs |
| atsAccountId | string | yes | ATS account ID of for which you want to get the ATS account jobs |
| include | array | no | Options to include more data: All, Hiring managers, Recruiters, Team members, Executives |
| postedToCareers | boolean | no | Option to filter jobs based on if they are posted to the careers page |
| status | string | no | Option to filter jobs by status |
| continuationToken | string | no |  |

### Get an ATS Account Job for ATS Account Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/applicant-tracking-system-get-job-by-job-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Paycor Legal Entity ID of the legal entity for which you want to get the ATS account job |
| atsAccountId | string | yes | ATS account ID of for which you want to get the ATS account job |
| atsJobId | string | yes | ATS Job ID |
| include | array | no | Options to include more data: All, Hiring managers, Recruiters, Team members, Executives |

### Get a list of ATS Accounts for Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/applicant-tracking-system-list-ats-accounts-by-legal-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Paycor Legal Entity ID of the legal entity for which you want to get the ATS accounts |
| continuationToken | string | no |  |

### Either Home Phone, Work Phone or Mobile Phone must be specified Data Access: Create Emergency Contact
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-emergency-contact-create-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes |  |
| body | object | yes | JSON request body |

### Get a list of Employee Certifications for an employee
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-certifications-list-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for which you want to get the certifications |
| continuationToken | string | no |  |

### Add Employee Certification
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-certifications-add-new-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add the certification |
| body | object | yes | JSON request body |

### Update Employee Certification
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-certifications-update-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for which you want to update the certifications |
| body | object | yes | JSON request body |

### Get Employee Custom Fields by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-custom-fields-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for whom you want to get the custom fields |
| continuationToken | string | no | Token to get the next set of employee custom fields |

### Update Custom Field by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-custom-fields-update-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to update the custom field |
| body | object | yes | JSON request body |

### Get Employee Deduction by EmployeeID and EmployeeDeductionID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-deductions-get-by-employee-id-and-deduction-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the deduction. |
| employeeDeductionId | string | yes | ID of the Employee Deduction you want to get. |
| include | array | no | Options to include more data: All, AmountData Data Access required AmountData = View Employee Deduction Amounts |

### Get Employee Deductions by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-deductions-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for whom you want to get the deductions |
| include | array | no | Options to include more data: All, AmountData Data Access required AmountData = View Employee Deductions Amounts |
| continuationToken | string | no | Token to get the next set of employee earnings |

### Add Deduction to Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-deductions-add-deduction-to-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add the deduction |
| body | object | yes | JSON request body |

### Update Employee Deduction by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-deductions-update-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee that has the Deduction you wish to update |
| body | object | yes | JSON request body |

### Get Employee HSA Direct Deposits by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-get-by-employee-id-hsa` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for whom you want to get HSA Direct Deposits |
| continuationToken | string | no | Token to get next set of HSA Direct Deposits |

### Add Employee HSA Direct Deposits by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-add-by-employee-id-hsa` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to add HSA Direct Deposits |
| body | object | yes | JSON request body |

### Update Employee HSA Direct Deposits by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-update-hsa-direct-deposits-by-emplo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to update HSA Direct Deposits |
| body | object | yes | JSON request body |

### Get Employee Direct Deposits by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to get Direct Deposits |
| continuationToken | string | no | Token to get next set of direct deposits |

### Add Employee Direct Deposits by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-add-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of employee for which you want to add Direct Deposits |
| body | object | yes | JSON request body |

### Update Employee Direct Deposits by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-update-by-employee-id-ddd` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to update Direct Deposit |
| body | object | yes | JSON request body |

### Get Employee Direct Deposit by EmployeeID and DirectDepositID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-direct-deposits-get-by-employee-and-deposit-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to get Direct Deposits |
| directDepositId | string | yes | ID of an employee direct deposit which you want to retrieve |

### Get Employee Pay Stubs document link by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-documents-get-pay-stub-document-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Pay Stubs Document Link |
| startDate | string | yes | Date that is earlier or equal to paycheck date |
| endDate | string | yes | Date that is after or equal to paycheck date |
| continuationToken | string | no | Token to get the next set of Employee Pay Stubs Document Links |

### Download Employee Pay Stub Document
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-documents-download-pay-stub` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of an Employee for whom you want to get the Pay Stub Document |
| documentId | string | yes | Id of Pay Stub Document |

### Get Employee Earning by EmployeeID and EmployeeEarningID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-earnings-get-by-employee-and-earning` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Earning |
| employeeEarningId | string | yes | ID of an Employee Earning you want to get |
| include | array | no | Options to include more data: All, AmountData Data Access required AmountData = View Employee Earning Amounts |

### Get Employee Earnings by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-earnings-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Earnings |
| include | array | no | Options to include more data: All, AmountData Data Access required AmountData = View Employee Earnings Amounts |
| continuationToken | string | no | Token to get the next set of Employee Earnings |

### Add Earning to Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-earnings-add-new-earning` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add an Earning |
| body | object | yes | JSON request body |

### Update Employee Earning
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-earnings-update-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee that has the Earning you wish to update |
| body | object | yes | JSON request body |

### Add Employee Hours And Earnings To Paygrid
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-payroll-hours-add-hours-and-earnings-to-paygrid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to set employee hours and earnings |
| replaceData | boolean | no | If "True" is passed for this query parameter and a matching ProcessID is passed, then the system will fully replace the entire record that… |
| appendData | boolean | no | If "True" is passed for this query parameter, then the system will NOT replace any record that was previously added. |
| body | object | yes | JSON request body |

### Import Payroll Hours to Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-payroll-hours-import-to-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add the payroll hours |
| body | object | yes | JSON request body |

### Get Employee I9 Verification by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-i9-verification-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for whom you want to get the I9 information |
| include | array | no | Options to include more data: documents |

### Update I9 Verification by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-i9-verification-update-by-employee-id-i9-verificati` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to update the I9 Verification |
| body | object | yes | JSON request body |

### Get Employee Payrates by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-rates-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to get payrates |
| continuationToken | string | no | Token to get next set of payrates |

### Add Payrate to Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-rates-add-new-rate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the Employee you wish to create the payrate for |
| body | object | yes | JSON request body |

### Update Employee Payrate by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-rates-update-by-employee-id-and-payrate-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee that has the Payrate you wish to update |
| payrateId | string | yes | ID of the Payrate you wish to update |
| body | object | yes | JSON request body |

### Get Employee Pay Schedule by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-schedule-get-upcoming-check-dates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the Employee for which you want to get the Pay Schedule |
| periodStartDate | string | no | Exact Period Start Date of Pay Schedule, to lookup specific payrun. |
| periodEndDate | string | no | Exact Period End Date of Pay Schedule, if you wish to filter - defaults to showing upcoming (future) runs |
| continuationToken | string | no | Token to get the next set of Employee Pay Schedule |
| include | array | no | Options to include more data: Additional Runs |

### Get Employee Pay Stubs by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-stubs-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Pay Stubs |
| checkDate | string | no | Check Date of Pay Stubs - required (unless processDate supplied) |
| processDate | string | no | Process Date of Pay Stubs - required (unless checkDate supplied) |
| plannerId | string | no | ID of the Planner for which you want to get the Pay Stubs. |
| include | array | no | Options to include more data: All, GrossAmount, NetAmount, Earnings, Taxes, Deductions Data Access required GrossAmount = View Paystub… |
| continuationToken | string | no | Token to get the next set of Employee Pay Stubs |

### Get Employee Pay Stubs by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-stubs-get-by-legal-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of a Legal entity for which you want to get the Pay Stubs |
| checkDate | string | no | Check Date of Pay Stubs - required (unless processDate supplied) |
| processDate | string | no | Process Date of Pay Stubs - required (unless checkDate supplied) |
| plannerId | string | no | ID of the Planner for which you want to get the Pay Stubs. |
| include | array | no | Options to include more data: All, GrossAmount, NetAmount, Earnings, Taxes, Deductions Data Access required GrossAmount = View Paystub… |
| continuationToken | string | no | Token to get the next set of Employee Pay Stubs |

### Get Employee Pay Stubs YTD by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-stubs-get-ytd-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Pay Stubs |
| toCheckDate | string | yes | Check Date of latest Pay Stub for YTD data. |
| include | array | no | Options to include more data: All, Earnings, Taxes, Deductions Data Access required Earnings = View Paystub Earning Information YTD Taxes… |

### Get Employee Pay Stubs YTD by Legal entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-pay-stubs-get-ytd-by-legal-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of a Legal entity for which you want to get the Pay Stubs |
| toCheckDate | string | yes | Check Date of latest Pay Stub for YTD data. |
| include | array | no | Options to include more data: All, Earnings, Taxes, Deductions Data Access required Earnings = View Paystub Earning Information YTD By… |
| continuationToken | string | no |  |

### Get Employee Schedules by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-legacy-perform-time-schedules-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to get schedules |
| startDate | string | no | Date range filter, showing which records to return |
| endDate | string | no | Date range filter, showing which records to return |

### Add Schedule to Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-legacy-perform-time-schedules-add-to-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add a schedule |
| body | object | yes | JSON request body |

### Get Employee Schedules by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-legacy-perform-time-schedules-get-by-legal-entity-i` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of Legal Entity for which you want to get schedules |
| startDate | string | no | Date range filter, showing which records to return |
| endDate | string | no | Date range filter, showing which records to return |
| continuationToken | string | no |  |

### Delete Employee Schedule
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-legacy-perform-time-schedules-delete-legacy-schedul` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Employee ID of the schedule record you want to delete |
| scheduleId | string | yes | Schedule ID to delete |

### Get Scheduling Jobs by LegalEntityID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-scheduling-get-scheduling-jobs-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Legal Entity ID |
| continuationToken | string | no |  |

### Get Employee by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employees-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the Employee you want to get |
| include | array | no | Options to include more data: All, EmploymentDates, Status, Position, WorkLocation Data Access required EmploymentDates = View Employee… |
| emailType | string | no | Options to specify which emaill address to return. Work email type will be returned if none are specified: Home, Work |

### Update Employee Contact
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| body | object | yes | JSON request body |

### Get Employees By TenantID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employees-list-by-tenant-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the tenant for which you want to get employees |
| statusFilter | string | no | Option to filter by employment status |
| employeeNumber | integer | no | Option to filter by Employee Number. |
| lastName | string | no | Option to filter by Employee Last Name. |
| departmentCode | integer | no | Option to filter by Department Code. |
| workLocationName | string | no | Option to filter by Work Location Name. |
| jobCode | string | no | Option to filter by Job Code. |
| continuationToken | string | no | Token to get the next set of employees |

### Get Employees by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employees-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get employees |
| include | array | no | Options to include more data: All, EmploymentDates, Status, Position, WorkLocation Data Access required EmploymentDates = View Legal… |
| emailType | string | no | Options to specify which email address to return. Work email type will be returned if none are specified: Home, Work |
| statusFilter | string | no | Option to filter by employment status. |
| employeeNumber | integer | no | Option to filter by Employee Number. |
| lastName | string | no | Option to filter by Employee Last Name. |
| departmentCode | integer | no | Option to filter by Department Code. |
| workLocationName | string | no | Option to filter by Work Location Name. |
| continuationToken | string | no | Token to get the next set of employees |

### Create Employee
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-create-new-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Update Employee Position and Status data
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-position-and-status-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| body | object | yes | JSON request body |

### Update Employee Position data
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-position-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| body | object | yes | JSON request body |

### Update Employee Status data
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-status-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| body | object | yes | JSON request body |

### Update Employee Personal data
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-personal-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| body | object | yes | JSON request body |

### GET Identifying Employee Data by Legal Entity Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/employees-get-identifying-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get employees |
| include | array | no | Options to filter employees by employment status: Active, Inactive |
| continuationToken | string | no | Token to get the next set of data |

### Update Employee Paygroup
`POST https://www.apizie.tech/v1/dev-tools:paycor/employees-update-paygroup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | Id of the employee |
| payGroupId | string | no | ID of the Paygroup for whom you want to get the Pay Schedule. Available via 'GET Legal Entity Pay Groups' |

### Create Employee Onboarding
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-onboarding-add-new-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get employees in the onboarding state
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-onboarding-list-onboarding-employees` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get the employees in the onboarding state |
| continuationToken | string | no | Token to get next set of Onboarding Employee records |

### Get Employee Taxes by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-taxes-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the employee for whom you want to get the taxes |
| include | array | no | Options to include more data: All, TaxCredits Data Access required TaxCredits = View Employee Tax Credits |
| continuationToken | string | no | Token to get the next set of employee taxes |

### Add Tax by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-taxes-add-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to add the tax |
| body | object | yes | JSON request body |

### Update Tax by EmployeeID
`POST https://www.apizie.tech/v1/dev-tools:paycor/employee-taxes-update-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to update the tax |
| body | object | yes | JSON request body |

### Get Filing Status by Tax Code
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-taxes-get-filing-status-by-tax-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| taxCode | string | yes | You can retrieve a valid Tax Code via Get Legal Entity Taxes by Legal Entity ID |

### Get Tax Fields by Tax Code
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-taxes-get-tax-fields-by-tax-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| taxCode | string | yes | You can retrieve a Tax fields by Tax Codes |

### Get Legal Entity Employees Time Card Punches by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-time-card-punches-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of legal entity for which you want to get hours |
| startDate | string | no | Date range filter, showing which records to return |
| endDate | string | no | Date range filter, showing which records to return |
| continuationToken | string | no | Token to get next set of Employee Time Cards. ContinuationToken would be valid only for 24 hours. If a call is made after 24 hours with… |

### Get Legal Entity Employees Time Card Punches by Employee ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-time-card-punches-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of employee for which you want to get hours |
| startDate | string | no | Date range filter, showing which records to return |
| endDate | string | no | Date range filter, showing which records to return |
| continuationToken | string | no | Token to get next set of Employee Time Cards. ContinuationToken would be valid only for 24 hours. If a call is made after 24 hours with… |

### Get Employee Accruals by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-time-off-accruals-get-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of an Employee for whom you want to get the Balances |
| continuationToken | string | no | Token to get the next set of Employee Balances |

### Get Employee Accruals by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/employee-time-off-accruals-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Legal entity ID for which you want to get the balances |
| continuationToken | string | no | Token to get the next set of employee balances |

### Get Employee Time Off Requests by EmployeeId
`GET https://www.apizie.tech/v1/dev-tools:paycor/time-off-requests-list-by-employee-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | ID of the Employee for which you want to get the Time Off Requests. |
| startDate | string | yes | Date range filter, showing which records to return. |
| endDate | string | yes | Date range filter, showing which records to return. |
| continuationToken | string | no | Token to get the next set of results. |

### Mock Event Notification
`POST https://www.apizie.tech/v1/dev-tools:paycor/events-notify-event-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get General Ledger by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/general-ledger-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get the general ledger items |
| plannerId | string | no | ID of planner, required if report type is regular |
| reportType | string | no | Type of General Ledger, Regular or Setup |
| include | array | no | Options to include more data: EmployeeData |
| continuationToken | string | no | Token to get next set of General Ledger records |

### Get General Ledger Job Costing by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/general-ledger-job-costing-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get the job costing items. |
| plannerId | string | yes | ID of planner. |
| include | array | no | Options to include more data: EmployeeData |
| continuationToken | string | no | Token to get next set of Job Costing records. |

### Get Labor Categories by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/labor-categories-by-legal-entity-id-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get labor categories (also known as job categories) |
| continuationToken | string | no |  |

### Get Labor Code By Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/labor-codes-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get labor codes (also known as job codes) |
| continuationToken | string | no |  |

### Add Labor Code to Legal Entity
`POST https://www.apizie.tech/v1/dev-tools:paycor/labor-codes-add-labor-code-to-legal-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to create Labor Code |
| body | object | yes | JSON request body |

### Update Labor Code
`POST https://www.apizie.tech/v1/dev-tools:paycor/labor-codes-update-specified-labor-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to update Labor Code |
| body | object | yes | JSON request body |

### GET /v1/legalentities/{legalEntityId}
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entities-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes |  |
| include | array | no |  |

### Get Legal Entities/Tenants for the user logged in
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entities-get-tenant-list` (byok)

### Get a list of Certification Organizations for a Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-certifications-list-certification-organizations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the certification organizations |
| continuationToken | string | no | Token to get the next set of certification organizations |

### Get a list of Certifications for a Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-certifications-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes |  |
| continuationToken | string | no |  |

### Get Legal Entity Deductions by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-deductions-view-employees-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the deductions |
| continuationToken | string | no | Token to get the next set of Legal Entity Deductions |

### Get Legal Entity Departments by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-departments-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Departments |
| continuationToken | string | no | Token to get the next set of Legal Entity Departments |

### Create Departments by Legal Entity Id
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-departments-create-new-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to create the Departments |
| body | object | yes | JSON request body |

### Update Legal Entity Department by Legal Entity ID
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-departments-update-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to update the Department |
| body | object | yes | JSON request body |

### Get Legal Entity Department by Legal Entity ID and Department ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-departments-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Departments |
| departmentId | string | yes | ID of the Department |

### GET /v1/legalentities/{legalEntityId}/earnings
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-earnings-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes |  |
| continuationToken | string | no |  |

### Get Job Titles by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-job-titles-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity you want to get Job Titles. |
| continuationToken | string | no | Token to get the next set of Job Titles |

### Get Legal Entity Pay Data by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-pay-data-get-pay-dates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Pay Data |
| employeeId | string | no | ID of an Employee, if you want to filter to paydata from a specific Employee |
| fromCheckDate | string | no | Filter Option 1: Date Range, From Check Date of Payrun |
| toCheckDate | string | no | Filter Option 1: Date Range, To Check Date of Payrun |
| processDate | string | no | Filter Option 2: Process Date of Payrun |
| plannerId | string | no | Filter Option 3: ID of the Planner for which you want to get the Pay Data. |
| continuationToken | string | no | Token to get the next set of Legal Entity Pay Data |

### Get Pay Groups by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-pay-groups-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Pay Groups |
| continuationToken | string | no | Token to get the next set of Legal Entity Pay Groups |

### GET Payroll Processing Data by Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-payroll-processing-data-get-by-legal-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Pay Groups |
| fromCheckDate | string | yes | Date range filter, From Check Date |
| toCheckDate | string | no | Date range filter, To Check Date |
| continuationToken | string | no | Token to get the next set of Legal Entity Payroll Processing Data |

### Get Legal Entity Pay Schedule by Legal Entity ID and Paygroup ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-pay-schedule-get-by-legal-entity-and-paygroup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Pay Schedule |
| payGroupId | string | no | ID of the Paygroup for whom you want to get the Pay Schedule. Available via 'GET Legal Entity Pay Groups' |
| asOfDate | string | no | Acts as a 'start date' filter - looks for Payruns that are in-progress or unpaid as of this date |
| untilDate | string | no | Acts as an 'end date' filter - looks for Payruns that are in-progress or unpaid until this date |
| continuationToken | string | no | Token to get the next set of Legal Entity Pay Schedule |

### Get Legal Entity Activity Types by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-activity-types-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | Legal Entity Id for whom you want to get the Activity Types |
| continuationToken | string | no |  |

### Get Schedules Groups for Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-schedule-groups-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity you want to get Schedule Groups |
| continuationToken | string | no | A token to get next set of results |

### Get subscribed services for Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-services-get-subscribed-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity you want to get (synonymous to Paycor's ClientID) |

### Get Legal Entity Status Reason values
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-status-reason-get-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the legal entity for which you want to get the status reasons items |
| statusCategory | string | yes | Status category of status reasons. |

### Get Legal Entity Taxes by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-taxes-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity you want to get (synonymous to Paycor's ClientID) the taxes |
| continuationToken | string | no | Token to get the next set of Legal Entity taxes |

### Create Punches for Employee(s) under Legal Entity
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-time-data-create-punches` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for whose employees you want to create punches |
| body | object | yes | JSON request body |

### Create Hours for Employee(s) under Legal Entity
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-time-data-create-hours-for-employee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for whose employees you want to create hours |
| body | object | yes | JSON request body |

### Get Punch error logs by Legal Entity Id And Tracking Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-time-data-get-punch-error-logs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Punch Error log. |
| trackingId | string | yes | ID of the Punch Create api failure result. |
| continuationToken | string | no |  |

### Get Employee Hour error logs by Legal Entity Id And Tracking Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-time-data-get-hour-error-log` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Hour Error log. |
| trackingId | string | yes | ID of the Hour Request Create api failure result. |
| continuationToken | string | no |  |

### Get Employee Time Off Requests by Legal Entity Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/time-off-requests-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Time Off Requests. |
| startDate | string | yes | Date range filter, showing which records to return. |
| endDate | string | yes | Date range filter, showing which records to return. |
| continuationToken | string | no | Token to get the next set of results. |

### Get Employee Timeoff Request by Legal Entity Id And Timeoff Request Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/time-off-requests-get-timeoff-request-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Timeoff Request. |
| timeoffRequestId | string | yes | ID of the Employee Timeoff Request. |

### Get Employee Timeoff Request error logs by Legal Entity Id And Tracking Id
`GET https://www.apizie.tech/v1/dev-tools:paycor/time-off-requests-get-error-logs-by-legal-entity-and-trackin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the Timeoff Request Error log. |
| trackingId | string | yes | ID of the Timeoff Request Create api failure result. |

### Get Legal Entity Time Off Types
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-time-off-types-view-time-off-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of an Legal Entity for which you want to get the Time Off Types |
| continuationToken | string | no | Token to get the next set of results |

### Get a list of Work Locations for a Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-locations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the work locations |
| continuationToken | string | no | Token to get the next set of work locations |

### Add Work Location By Legal Entity ID
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-locations-add-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes |  |
| addressData | boolean | no | Use Physical Address as mailing address? |
| body | object | yes | JSON request body |

### Update Work Location By Legal Entity ID
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-locations-update-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the work locations |
| body | object | yes | JSON request body |

### Get a Work Location for a Legal Entity By Legal Entity ID and Work Location ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-locations-get-by-legal-entity-and-location` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the work location |
| workLocationId | string | yes | ID of the Work Location |

### Delete Work Location By Work Location ID And Legal Entity ID
`POST https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-locations-delete-by-legal-entity-and-work` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to delete Work Location |
| workLocationId | string | yes | ID of the Work Location |

### Get Work Sites for Legal Entity
`GET https://www.apizie.tech/v1/dev-tools:paycor/legal-entity-work-sites-get-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity you want to get Work Sites |
| continuationToken | string | no | A token to get next set of results |

### Get Persons by Legal Entity ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/persons-list-by-legal-entity-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| legalEntityId | integer | yes | ID of the Legal Entity for which you want to get the persons |
| include | array | no | Options to include more data: All, Demographic, Benefit, Military, SocialMedia, Addresses, EmployeeAssignments, SocialSecurityNumber,… |
| continuationToken | string | no | Token to get the next set of persons |

### Get Persons By TenantID
`GET https://www.apizie.tech/v1/dev-tools:paycor/persons-list-by-tenant-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the Tenant for which you want to get persons |
| continuationToken | string | no | Token to get the next set of persons |

### Get Person By TenantID And PersonID
`GET https://www.apizie.tech/v1/dev-tools:paycor/persons-get-by-tenant-and-person` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the Tenant that the Person is in |
| personId | string | yes | ID of the Person you want to get |
| include | array | no | Options to include more data: All, Demographic, Benefit, Military, SocialMedia, Addresses, EmployeeAssignments, EmergencyContact,… |

### Get Person by EmployeeID
`GET https://www.apizie.tech/v1/dev-tools:paycor/persons-get-by-employee-id-person` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employeeId | string | yes | EmployeeID linked to the Person you want to get |
| include | array | no | Options to include more data: All, Demographic, Benefit, Military, SocialMedia, Addresses, EmployeeAssignments, EmergencyContact,… |

### Get Tenant by TenantID
`GET https://www.apizie.tech/v1/dev-tools:paycor/tenants-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the Tenant you want to get |

### Get Tenant Work Locations by TenantID
`GET https://www.apizie.tech/v1/dev-tools:paycor/tenants-get-work-locations-by-tenant-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the Tenant you want to get work locations. |
| continuationToken | string | no | Token to get the next set of work locations |

### Get All Job Titles by Tenant ID
`GET https://www.apizie.tech/v1/dev-tools:paycor/job-titles-list-by-tenant-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tenantId | integer | yes | ID of the Tenant you want to get Job Titles. |
| continuationToken | string | no | Token to get the next set of Job Titles |

## Example
```
curl "https://www.apizie.tech/v1/dev-tools:paycor/applicant-tracking-system-get-account-jobs" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Paycor Public API API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/dev-tools:paycor/applicant-tracking-system-get-account-jobs with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Paycor Public API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Paycor Public API itself also needs your own key from apis.paycor.com.

### Can AI agents use the Paycor Public API API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:paycor.

### What is the status of the Paycor Public API API?
Needs your own provider key (bring your own key)