Justworks website screenshot

Justworks

Justworks is a New York City-based Professional Employer Organization (PEO) and small-business HR platform. It bundles payroll, tax filing, multi-state compliance, large-group medical/dental/vision benefits, 401(k) administration, workers comp, time tracking, and HR consulting into a single per-employee-per-month subscription. Justworks operates four primary products: Justworks Payroll (standalone payroll), Justworks PEO Basic, Justworks PEO Plus (PEO with included benefits package), and Justworks EOR International for hiring full-time employees abroad without a local entity. Justworks exposes a Partner API at public-api.justworks.com for approved integration partners, covering Members, Company, Payroll, Paystubs, Deductions, Time Off, and Webhooks. The API uses OAuth 2.0 authorization-code grant, cursor pagination, signed at-least-once webhooks, and zero-decimal currency representation. Deductions is the primary write surface; everything else is read-only.

Justworks publishes 11 APIs on the APIs.io network, including Members API, Company API, Deductions API, and 8 more. Tagged areas include PEO, Payroll, HR, Human Resources, and Benefits.

The Justworks catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Justworks’ developer surface includes authentication, documentation, developer portal, getting-started guide, pricing, engineering blog, YouTube channel, and 17 more developer resources.

🌐 Visit website 📡 Source on GitHub
57.4/100 strong ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
11 APIs 18 Features
PEOPayrollHRHuman ResourcesBenefitsHealth Insurance401(k)Time OffComplianceSmall BusinessEmployer of RecordHRIS

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 57.4/100 · strong
Contract Quality 17.9 / 25
Developer Ergonomics 9.1 / 20
Commercial Clarity 11.6 / 20
Operational Transparency 3.4 / 13
Governance 7.0 / 12
Discoverability 6.5 / 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/justworks: 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 11

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

Justworks Members API

Read employee, contractor, and member information from the Justworks Partner API. Provides access to member profiles, employment history, pay history, custom-field values, and U...

Justworks Company API

Read company-level data from the Justworks Partner API including company identity, departments, offices, bank account on file (masked), verified business information, custom-fie...

Justworks Deductions API

Manage employee deductions — list deduction types, create one-time and recurring deductions, update existing deductions, and cancel deductions in bulk. The primary write surface...

Justworks Webhooks API

Manage Justworks Partner API webhooks. Justworks signs every request, delivers events at-least-once with automatic retries, and closes a webhook on sustained failures (resumable...

Justworks OAuth API

OAuth 2.0 token endpoints for the Justworks Partner API. Authorization code is the only supported grant for initial token acquisition; refresh token grant is supported for renew...

Justworks Deduction Types API

Read access to Justworks deduction type catalog

Justworks Payrolls API

Read access to payroll runs and per-payroll fees

Justworks Paystubs API

Read access to per-member paystubs

Justworks Time Off Balances API

Asynchronous balance reports for time-off policies

Justworks Time Off Policies API

Read access to time-off policy catalog

Justworks Time Off Requests API

Read access to time-off requests submitted by members

Scroll for all 11

Open Collections 7

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

Justworks Company API

OPEN COLLECTION

Justworks Deductions API

OPEN COLLECTION

Justworks Members API

OPEN COLLECTION

Justworks OAuth API

OPEN COLLECTION

Justworks Payroll API

OPEN COLLECTION

Justworks Time Off API

OPEN COLLECTION

Justworks Webhooks API

OPEN COLLECTION

Scroll for all 7

Pricing Plans 1

Published pricing tiers and plan structures.

Justworks Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Justworks Rate Limits

2 limits

RATE LIMITS

FinOps 1

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

Justworks Finops

FINOPS

Features 18

Notable capabilities this provider offers.

Justworks PEO Basic — co-employment PEO with payroll, HR support, and access to large-group benefits
Justworks PEO Plus — PEO Basic plus medical, dental, vision, life, AD&D, disability, and 401(k) administration
Justworks Payroll — standalone small-business payroll, time tracking, and HR tooling for companies that source their own benefits
Justworks EOR International — employer-of-record service for hiring full-time employees abroad without a local entity
Justworks Partner API at public-api.justworks.com with OAuth 2.0 authorization-code flow
Members endpoints (list, get, custom field values, tax-id/SSN) with cursor pagination and updated_at filtering
Company endpoints (identity, bank account, business info, custom fields, jurisdictions)
Payroll endpoints (list runs by date range, list fees, list paystubs, get paystub with earnings + deductions + employer contributions)
Deductions endpoints (list types, list, create, update, cancel) with per-row operation_id idempotency
Time Off endpoints (asynchronous balance reports, policies, requests)
Signed webhooks for member.profile.created/updated, member.employment_state.termination_scheduled/canceled, and department.created/updated/deleted
Webhook simulator endpoint for partner-listener validation in the Tour environment
24-hour access tokens and 30-day refresh tokens
Hierarchical OAuth scopes (e.g., member.detail:read implies member.basic:read implies member.dob/sex:read)
Zero-decimal currency representation for all monetary fields
Partner program with revenue share, co-marketing, dedicated relationship managers
Integrations marketplace covering Greenhouse, Lever, JazzHR, CultureAmp, 15Five, QuickBooks, NetSuite, Xero, Sage Intacct, Brex, Ramp
Available via aggregator platforms Finch, Merge, and Apideck for cross-HRIS access

Scroll for all 18

Semantic Vocabularies 1

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

Justworks Context

0 classes · 8 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Justworks API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 6

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

Justworks Deduction

10 properties

JSON SCHEMA

Justworks Member

27 properties

JSON SCHEMA

Justworks Payroll

10 properties

JSON SCHEMA

Justworks Paystub

12 properties

JSON SCHEMA

Justworks Time Off Request

11 properties

JSON SCHEMA

Justworks Webhook Event

5 properties

JSON SCHEMA

Security Posture 3

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

Justworks Authentication

oauth2 · 1 scheme

SECURITY

Justworks Domain Security

TLSv1.3 · DMARC

SECURITY

Justworks Vulnerability Disclosure

security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Justworks Scopes

15 scopes · authorizationCode

15 scopes

SCOPES

Agentic Access 1

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

Justworks Agentic Access

27 operations · 9 acting · 1 human-in-the-loop

27 operations · 9 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal
Portal
 GettingStarted
GettingStarted

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes
 TrustCenter
TrustCenter

Learn 1

Tutorials, courses, talks, and written guidance

YouTube
YouTube

Operate 2

Status, limits, changes, and where to get help

HelpCenter
HelpCenter
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 Plans
Plans
 FinOps
FinOps

Company 7

The organization behind the API

Website
Website
 PartnerProgram
PartnerProgram
 PartnerBlog
PartnerBlog
 Blog
Blog
 Careers
Careers
 LinkedIn
LinkedIn
 Twitter
Twitter

Scroll for all 7

Other 1

Properties that don't map to a standard resource type

Products
Products

Source (apis.yml)

apis.yml Raw ↑ 
aid: justworks
url: https://raw.githubusercontent.com/api-evangelist/justworks/refs/heads/main/apis.yml
apis:
- aid: justworks:justworks-members-api
  name: Justworks Members API
  tags:
  - HR
  - PEO
  - Members
  - Employees
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-members-api-openapi.yml
    type: OpenAPI
  - url: json-schema/justworks-member-schema.json
    type: JSONSchema
  - url: json-ld/justworks-context.jsonld
    type: JSONLD
  description: 'Read employee, contractor, and member information from the Justworks Partner API. Provides access to

    member profiles, employment history, pay history, custom-field values, and U.S. tax identifiers

    (SSN) for domestic members. This is the canonical workforce-truth surface a partner integrates

    against. Uses cursor pagination with a hard cap of 100 items per page.

    '
- aid: justworks:justworks-company-api
  name: Justworks Company API
  tags:
  - HR
  - PEO
  - Company
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-company-api-openapi.yml
    type: OpenAPI
  description: 'Read company-level data from the Justworks Partner API including company identity, departments,

    offices, bank account on file (masked), verified business information, custom-field definitions,

    and the jurisdictions in which the company operates.

    '
- aid: justworks:justworks-deductions-api
  name: Justworks Deductions API
  tags:
  - Deductions
  - Payroll
  - PEO
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-deductions-api-openapi.yml
    type: OpenAPI
  - url: json-schema/justworks-deduction-schema.json
    type: JSONSchema
  description: 'Manage employee deductions — list deduction types, create one-time and recurring deductions,

    update existing deductions, and cancel deductions in bulk. The primary write surface of the

    Justworks Partner API. Each item carries a partner-supplied operation_id for idempotency.

    '
- aid: justworks:justworks-webhooks-api
  name: Justworks Webhooks API
  tags:
  - Webhooks
  - Events
  - HR
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-webhooks-api-openapi.yml
    type: OpenAPI
  - url: json-schema/justworks-webhook-event-schema.json
    type: JSONSchema
  description: 'Manage Justworks Partner API webhooks. Justworks signs every request, delivers events at-least-once

    with automatic retries, and closes a webhook on sustained failures (resumable via API). Event types

    cover member.profile.*, member.employment_state.termination_*, and department.* lifecycle changes.

    A Tour-environment simulate endpoint allows partners to validate their listener without real data.

    '
- aid: justworks:justworks-oauth-api
  name: Justworks OAuth API
  tags:
  - OAuth
  - Authentication
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-oauth-api-openapi.yml
    type: OpenAPI
  description: 'OAuth 2.0 token endpoints for the Justworks Partner API. Authorization code is the only supported

    grant for initial token acquisition; refresh token grant is supported for renewal. Access tokens are

    valid for 24 hours; refresh tokens are valid for 30 days. A revoke endpoint is provided for both

    access and refresh tokens.

    '
- aid: justworks:justworks-deduction-types-api
  name: Justworks Deduction Types API
  description: Read access to Justworks deduction type catalog
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Deduction Types
  properties:
  - type: OpenAPI
    url: openapi/justworks-deduction-types-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
- aid: justworks:justworks-payrolls-api
  name: Justworks Payrolls API
  description: Read access to payroll runs and per-payroll fees
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Payrolls
  properties:
  - type: OpenAPI
    url: openapi/justworks-payrolls-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
- aid: justworks:justworks-paystubs-api
  name: Justworks Paystubs API
  description: Read access to per-member paystubs
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Paystubs
  properties:
  - type: OpenAPI
    url: openapi/justworks-paystubs-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
- aid: justworks:justworks-time-off-balances-api
  name: Justworks Time Off Balances API
  description: Asynchronous balance reports for time-off policies
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Time Off Balances
  properties:
  - type: OpenAPI
    url: openapi/justworks-time-off-balances-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
- aid: justworks:justworks-time-off-policies-api
  name: Justworks Time Off Policies API
  description: Read access to time-off policy catalog
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Time Off Policies
  properties:
  - type: OpenAPI
    url: openapi/justworks-time-off-policies-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
- aid: justworks:justworks-time-off-requests-api
  name: Justworks Time Off Requests API
  description: Read access to time-off requests submitted by members
  humanURL: https://public-api.justworks.com/v1/docs
  tags:
  - Time Off Requests
  properties:
  - type: OpenAPI
    url: openapi/justworks-time-off-requests-api-openapi.yml
  - type: Documentation
    url: https://public-api.justworks.com/v1/docs
  - type: JSONSchema
    url: json-schema/justworks-payroll-schema.json
  - type: JSONSchema
    url: json-schema/justworks-paystub-schema.json
  - type: JSONSchema
    url: json-schema/justworks-time-off-request-schema.json
common:
- type: AgenticAccess
  url: agentic-access/justworks-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/justworks-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/justworks-domain-security.yml
- type: Authentication
  url: authentication/justworks-authentication.yml
- type: OAuthScopes
  url: scopes/justworks-scopes.yml
- type: Website
  url: https://www.justworks.com
- type: Documentation
  url: https://public-api.justworks.com/v1/docs
- type: Portal
  url: https://www.justworks.com/partners
- type: GettingStarted
  url: https://public-api.justworks.com/v1/docs
- type: Pricing
  url: https://www.justworks.com/pricing
- type: Products
  url: https://www.justworks.com/products
- type: Integrations
  url: https://www.justworks.com/integrations
- type: PartnerProgram
  url: https://www.justworks.com/partners
- type: Integrations
  url: https://www.justworks.com/partners/integrations
- type: PartnerBlog
  url: https://www.justworks.com/partners/blog
- type: HelpCenter
  url: https://help.justworks.com
- type: TrustCenter
  url: https://trust.justworks.com
- type: Blog
  url: https://www.justworks.com/blog
- type: Careers
  url: https://www.justworks.com/careers
- type: GitHubOrganization
  url: https://github.com/justworkshr
- type: LinkedIn
  url: https://www.linkedin.com/company/justworks
- type: Twitter
  url: https://twitter.com/JustworksHR
- type: YouTube
  url: https://www.youtube.com/c/Justworks
- type: Plans
  url: plans/justworks-plans-pricing.yml
- type: RateLimits
  url: rate-limits/justworks-rate-limits.yml
- type: FinOps
  url: finops/justworks-finops.yml
- type: Features
  data:
  - Justworks PEO Basic — co-employment PEO with payroll, HR support, and access to large-group benefits
  - Justworks PEO Plus — PEO Basic plus medical, dental, vision, life, AD&D, disability, and 401(k) administration
  - Justworks Payroll — standalone small-business payroll, time tracking, and HR tooling for companies that source their own
    benefits
  - Justworks EOR International — employer-of-record service for hiring full-time employees abroad without a local entity
  - Justworks Partner API at public-api.justworks.com with OAuth 2.0 authorization-code flow
  - Members endpoints (list, get, custom field values, tax-id/SSN) with cursor pagination and updated_at filtering
  - Company endpoints (identity, bank account, business info, custom fields, jurisdictions)
  - Payroll endpoints (list runs by date range, list fees, list paystubs, get paystub with earnings + deductions + employer
    contributions)
  - Deductions endpoints (list types, list, create, update, cancel) with per-row operation_id idempotency
  - Time Off endpoints (asynchronous balance reports, policies, requests)
  - Signed webhooks for member.profile.created/updated, member.employment_state.termination_scheduled/canceled, and department.created/updated/deleted
  - Webhook simulator endpoint for partner-listener validation in the Tour environment
  - 24-hour access tokens and 30-day refresh tokens
  - Hierarchical OAuth scopes (e.g., member.detail:read implies member.basic:read implies member.dob/sex:read)
  - Zero-decimal currency representation for all monetary fields
  - Partner program with revenue share, co-marketing, dedicated relationship managers
  - Integrations marketplace covering Greenhouse, Lever, JazzHR, CultureAmp, 15Five, QuickBooks, NetSuite, Xero, Sage Intacct,
    Brex, Ramp
  - Available via aggregator platforms Finch, Merge, and Apideck for cross-HRIS access
  sources:
  - https://public-api.justworks.com/v1/docs
  - https://www.justworks.com/pricing
  - https://www.justworks.com/integrations
  - https://www.justworks.com/partners/integrations
name: Justworks
description: 'Justworks is a New York City-based Professional Employer Organization (PEO) and small-business HR

  platform. It bundles payroll, tax filing, multi-state compliance, large-group medical/dental/vision

  benefits, 401(k) administration, workers comp, time tracking, and HR consulting into a single

  per-employee-per-month subscription. Justworks operates four primary products: Justworks Payroll

  (standalone payroll), Justworks PEO Basic, Justworks PEO Plus (PEO with included benefits package),

  and Justworks EOR International for hiring full-time employees abroad without a local entity.


  Justworks exposes a Partner API at public-api.justworks.com for approved integration partners,

  covering Members, Company, Payroll, Paystubs, Deductions, Time Off, and Webhooks. The API uses OAuth

  2.0 authorization-code grant, cursor pagination, signed at-least-once webhooks, and zero-decimal

  currency representation. Deductions is the primary write surface; everything else is read-only.

  '
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Provider
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/justworks.png
tags:
- PEO
- Payroll
- HR
- Human Resources
- Benefits
- Health Insurance
- 401(k)
- Time Off
- Compliance
- Small Business
- Employer of Record
- HRIS
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'