Paychex

Paychex, Inc. (NASDAQ: PAYX) is a Rochester, New York-based provider of integrated payroll, human resources, retirement, insurance, and benefits outsourcing services for small- and medium-sized businesses, with developer APIs exposed through the Paychex Flex platform.

Paychex publishes 3 APIs on the APIs.io network: Companies API, Time Entries API, and Workers API. Tagged areas include Benefits, HCM, HR, Paychex Flex, and Payroll.

The Paychex catalog on APIs.io includes 3 JSON-LD contexts and 2 Spectral governance rulesets.

Paychex’s developer surface includes authentication, developer portal, documentation, getting-started guide, YouTube channel, engineering blog, and 22 more developer resources.

🌐 Visit website 📡 Source on GitHub

53.8/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

3 APIs 6 Features 5 Use Cases

BenefitsHCMHRPaychex FlexPayrollTime and AttendanceWorkforceFortune 1000

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 53.8/100 · developing

Contract Quality 19.3 / 25

Developer Ergonomics 8.3 / 20

Commercial Clarity 5.8 / 20

Operational Transparency 4.8 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 31/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/paychex-developer: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Paychex Companies API

Companies available to the registered application.

Paychex Time Entries API

Time entry, punch, and time-worked submissions.

Paychex Workers API

Employees and contractors for a Paychex Flex company.

Open Collections 3

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Paychex Payroll Companies API

OPEN COLLECTION

Paychex Time API

OPEN COLLECTION

Paychex Workers API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Paychex Developer Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Paychex Developer Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Paychex Developer Finops

FINOPS

Features 6

Notable capabilities this provider offers.

Company-Scoped Access

Every API call is scoped to a company resource that the registered application has been granted explicit access to, enforcing tenant isolation across Paychex Flex clients.

Worker Lifecycle Management

List, retrieve, and update worker records — including personal information, work assignments, and pay rates — for hire-to-retire HR workflows.

Time Data Ingest

Submit time entries, punches, and time-worked records from third-party time and attendance systems so they flow into Paychex Payroll processing.

OAuth 2.0 Client Credentials

All APIs are protected by an OAuth 2.0 client_credentials flow tied to a registered Paychex partner or client application; there is no end-user OAuth dance.

Partner-Approved Integrations

Production access is gated behind partner registration and Paychex approval; sandbox credentials are issued during integration review rather than via self-serve signup.

Paychex Flex Native

APIs read and write against the same Paychex Flex platform used by ~800,000 payroll clients, so changes flow through the same payroll, HR, and benefits engines.

Semantic Vocabularies 3

JSON-LD contexts and semantic vocabularies used across these APIs.

Paychex Companies Context

8 classes · 0 properties

JSON-LD

Paychex Developer Context

23 classes · 0 properties

JSON-LD

Paychex Workers Context

19 classes · 0 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Paychex API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Paychex API Rules

9 rules · 4 errors 5 warnings

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Paychex Company

7 properties

JSON SCHEMA

Paychex Time Entry

7 properties

JSON SCHEMA

Paychex Worker

7 properties

JSON SCHEMA

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Paychex Companies Company Structure

7 properties

JSON STRUCTURE

Paychex Workers Worker Structure

6 properties

JSON STRUCTURE

Examples 6

Example request and response payloads for these APIs.

Paychex Companies Getcompany Example

1 fields

EXAMPLE

Paychex Companies Listcompanies Example

2 fields

EXAMPLE

Paychex Time Createtimeentries Request Example

2 fields

EXAMPLE

Paychex Time Createtimeentries Response Example

3 fields

EXAMPLE

Paychex Workers Getcompanyworker Example

1 fields

EXAMPLE

Paychex Workers Listcompanyworkers Example

2 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Paychex Developer Authentication

oauth2 · 1 scheme

SECURITY

Paychex Developer Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Paychex Developer Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Paychex Developer Agentic Access

5 operations · 1 acting

AGENTIC

Use Cases 5

What developers build with this provider.

HRIS and Payroll Sync

Keep an external HRIS or workforce-management system in sync with Paychex Flex by listing companies, mirroring workers, and reconciling pay and assignment changes.

Time and Attendance Integration

Push punches, time entries, and time-worked totals from third-party time tracking tools into Paychex Payroll so labor data drives paychecks automatically.

Onboarding Automation

Trigger downstream onboarding workflows — provisioning, benefits, equipment — when a new worker is created or activated in Paychex Flex.

Embedded Payroll for Partners

ISVs and vertical SaaS platforms surface Paychex payroll inside their own product, using the developer APIs to read companies and workers and feed payroll inputs.

Analytics and Workforce Reporting

Pull worker, company, and time data into BI and people-analytics stacks for headcount, labor cost, and compliance reporting.

Integrations 5

Pre-built integrations with other platforms and tools.

Paychex Flex

Native integration with Paychex Flex — the cloud HR, payroll, time, and benefits platform that the developer APIs sit on top of.

Paychex Time

Native time and attendance product whose data model is exposed (and writable) via the Paychex Time API for third-party time vendors.

Paychex HR PEO

Professional Employer Organization (PEO) co-employment services that share the same underlying worker and company records exposed via the developer APIs.

Paychex Marketplace

Partner marketplace where vetted ISVs publish integrations built on the Paychex developer APIs.

Paycor (Acquired 2025)

Paychex completed its $4.1B acquisition of Paycor in 2025, expanding the HCM surface area covered by the broader Paychex platform.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Documentation 6

Reference material describing how the API behaves

Documentation

Documentation

Paychex Payroll Companies OpenAPI

OpenAPI

Paychex Workers OpenAPI

OpenAPI

Paychex Time OpenAPI

OpenAPI

Paychex Company JSON Schema

JSONSchema

Paychex Worker JSON Schema

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Paychex JSON-LD Context

JSONLD

Paychex Vocabulary

Vocabulary

Paychex Spectral Rules

SpectralRules

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 4

Authentication, authorization, and security posture

DomainSecurity

Authentication

OAuthScopes

Authentication

Learn 1

Tutorials, courses, talks, and written guidance

YouTube

YouTube

Operate 2

Status, limits, changes, and where to get help

SupportContact

SupportContact

Paychex Rate Limits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Paychex Plans and Pricing

Plans

Paychex FinOps Profile

FinOps

Company 5

The organization behind the API

LinkedIn

Facebook

Facebook

Blog

Blog

Newsroom

Newsroom

InvestorRelations

InvestorRelations

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

aid: paychex-developer
name: Paychex
description: 'Paychex, Inc. (NASDAQ: PAYX) is a Rochester, New York-based provider of integrated payroll, human resources,
  retirement, insurance, and benefits outsourcing services for small- and medium-sized businesses, with developer APIs exposed
  through the Paychex Flex platform.'
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://raw.githubusercontent.com/api-evangelist/paychex-developer/refs/heads/main/image.png
url: https://raw.githubusercontent.com/api-evangelist/paychex-developer/refs/heads/main/apis.yml
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.19'
kind: contract
access: 3rd-Party
apis:
- aid: paychex-developer:paychex-developer-companies-api
  name: Paychex Companies API
  description: Companies available to the registered application.
  humanURL: https://developer.paychex.com/
  baseURL: https://api.paychex.com
  tags:
  - Companies
  properties:
  - type: OpenAPI
    url: openapi/paychex-developer-companies-api-openapi.yml
  - type: Documentation
    url: https://developer.paychex.com/documentation
  - type: GettingStarted
    url: https://developer.paychex.com/getting-started/overview
  - type: Authentication
    url: https://developer.paychex.com/getting-started/overview
  - type: JSONSchema
    url: json-schema/paychex-companies-company-schema.json
  - type: JSONLD
    url: json-ld/paychex-companies-context.jsonld
  - type: JSONSchema
    url: json-schema/paychex-workers-worker-schema.json
  - type: JSONLD
    url: json-ld/paychex-workers-context.jsonld
- aid: paychex-developer:paychex-developer-time-entries-api
  name: Paychex Time Entries API
  description: Time entry, punch, and time-worked submissions.
  humanURL: https://developer.paychex.com/
  baseURL: https://api.paychex.com
  tags:
  - Time Entries
  properties:
  - type: OpenAPI
    url: openapi/paychex-developer-time-entries-api-openapi.yml
  - type: Documentation
    url: https://developer.paychex.com/documentation
  - type: GettingStarted
    url: https://developer.paychex.com/getting-started/overview
  - type: Authentication
    url: https://developer.paychex.com/getting-started/overview
  - type: JSONSchema
    url: json-schema/paychex-companies-company-schema.json
  - type: JSONLD
    url: json-ld/paychex-companies-context.jsonld
  - type: JSONSchema
    url: json-schema/paychex-workers-worker-schema.json
  - type: JSONLD
    url: json-ld/paychex-workers-context.jsonld
- aid: paychex-developer:paychex-developer-workers-api
  name: Paychex Workers API
  description: Employees and contractors for a Paychex Flex company.
  humanURL: https://developer.paychex.com/
  baseURL: https://api.paychex.com
  tags:
  - Workers
  properties:
  - type: OpenAPI
    url: openapi/paychex-developer-workers-api-openapi.yml
  - type: Documentation
    url: https://developer.paychex.com/documentation
  - type: GettingStarted
    url: https://developer.paychex.com/getting-started/overview
  - type: Authentication
    url: https://developer.paychex.com/getting-started/overview
  - type: JSONSchema
    url: json-schema/paychex-companies-company-schema.json
  - type: JSONLD
    url: json-ld/paychex-companies-context.jsonld
  - type: JSONSchema
    url: json-schema/paychex-workers-worker-schema.json
  - type: JSONLD
    url: json-ld/paychex-workers-context.jsonld
common:
- type: AgenticAccess
  url: agentic-access/paychex-developer-agentic-access.yml
- type: DomainSecurity
  url: security/paychex-developer-domain-security.yml
- type: Authentication
  url: authentication/paychex-developer-authentication.yml
- type: OAuthScopes
  url: scopes/paychex-developer-scopes.yml
- type: Portal
  url: https://developer.paychex.com/
- type: Documentation
  url: https://developer.paychex.com/documentation
- type: GettingStarted
  url: https://developer.paychex.com/getting-started/overview
- type: Authentication
  url: https://developer.paychex.com/getting-started/overview
- type: GitHubOrganization
  url: https://github.com/paychex
- type: LinkedIn
  url: https://www.linkedin.com/company/paychex
- type: X
  url: https://x.com/Paychex
- type: Facebook
  url: https://www.facebook.com/Paychex
- type: YouTube
  url: https://www.youtube.com/user/PaychexInc
- type: Blog
  url: https://www.paychex.com/articles
- type: Newsroom
  url: https://www.paychex.com/newsroom
- type: InvestorRelations
  url: https://investor.paychex.com/
- type: SupportContact
  url: https://developer.paychex.com/support
- type: OpenAPI
  url: openapi/paychex-payroll-companies-openapi.yml
  title: Paychex Payroll Companies OpenAPI
- type: OpenAPI
  url: openapi/paychex-workers-openapi.yml
  title: Paychex Workers OpenAPI
- type: OpenAPI
  url: openapi/paychex-time-openapi.yml
  title: Paychex Time OpenAPI
- type: JSONSchema
  url: json-schema/paychex-companies-company-schema.json
  title: Paychex Company JSON Schema
- type: JSONSchema
  url: json-schema/paychex-workers-worker-schema.json
  title: Paychex Worker JSON Schema
- type: JSONLD
  url: json-ld/paychex-developer-context.jsonld
  title: Paychex JSON-LD Context
- type: Plans
  url: plans/paychex-developer-plans-pricing.yml
  title: Paychex Plans and Pricing
- type: RateLimits
  url: rate-limits/paychex-developer-rate-limits.yml
  title: Paychex Rate Limits
- type: FinOps
  url: finops/paychex-developer-finops.yml
  title: Paychex FinOps Profile
- type: Vocabulary
  url: vocabulary/paychex-developer-vocabulary.yml
  title: Paychex Vocabulary
- type: SpectralRules
  url: rules/paychex-developer-rules.yml
  title: Paychex Spectral Rules
- type: Features
  data:
  - name: Company-Scoped Access
    description: Every API call is scoped to a company resource that the registered application has been granted explicit
      access to, enforcing tenant isolation across Paychex Flex clients.
  - name: Worker Lifecycle Management
    description: List, retrieve, and update worker records — including personal information, work assignments, and pay rates
      — for hire-to-retire HR workflows.
  - name: Time Data Ingest
    description: Submit time entries, punches, and time-worked records from third-party time and attendance systems so they
      flow into Paychex Payroll processing.
  - name: OAuth 2.0 Client Credentials
    description: All APIs are protected by an OAuth 2.0 client_credentials flow tied to a registered Paychex partner or client
      application; there is no end-user OAuth dance.
  - name: Partner-Approved Integrations
    description: Production access is gated behind partner registration and Paychex approval; sandbox credentials are issued
      during integration review rather than via self-serve signup.
  - name: Paychex Flex Native
    description: APIs read and write against the same Paychex Flex platform used by ~800,000 payroll clients, so changes flow
      through the same payroll, HR, and benefits engines.
- type: UseCases
  data:
  - name: HRIS and Payroll Sync
    description: Keep an external HRIS or workforce-management system in sync with Paychex Flex by listing companies, mirroring
      workers, and reconciling pay and assignment changes.
  - name: Time and Attendance Integration
    description: Push punches, time entries, and time-worked totals from third-party time tracking tools into Paychex Payroll
      so labor data drives paychecks automatically.
  - name: Onboarding Automation
    description: Trigger downstream onboarding workflows — provisioning, benefits, equipment — when a new worker is created
      or activated in Paychex Flex.
  - name: Embedded Payroll for Partners
    description: ISVs and vertical SaaS platforms surface Paychex payroll inside their own product, using the developer APIs
      to read companies and workers and feed payroll inputs.
  - name: Analytics and Workforce Reporting
    description: Pull worker, company, and time data into BI and people-analytics stacks for headcount, labor cost, and compliance
      reporting.
- type: Integrations
  data:
  - name: Paychex Flex
    description: Native integration with Paychex Flex — the cloud HR, payroll, time, and benefits platform that the developer
      APIs sit on top of.
  - name: Paychex Time
    description: Native time and attendance product whose data model is exposed (and writable) via the Paychex Time API for
      third-party time vendors.
  - name: Paychex HR PEO
    description: Professional Employer Organization (PEO) co-employment services that share the same underlying worker and
      company records exposed via the developer APIs.
  - name: Paychex Marketplace
    description: Partner marketplace where vetted ISVs publish integrations built on the Paychex developer APIs.
  - name: Paycor (Acquired 2025)
    description: Paychex completed its $4.1B acquisition of Paycor in 2025, expanding the HCM surface area covered by the
      broader Paychex platform.
maintainers:
- name: Kin Lane
  email: kin@apievangelist.com
tags:
- Benefits
- HCM
- HR
- Paychex Flex
- Payroll
- Time and Attendance
- Workforce
- Fortune 1000