Home Providers Justworks
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.
2 APIs18 Features
On this page
Kin Score
APIs 11
Open Collections 14
Pricing Plans 1
Rate Limits 1
FinOps 1
Features 18
Vocabularies 1
Spectral Rules 1
JSON Schema 6
Security Posture 3
Scopes 1
Agentic Access 1
Resources 24
apis.yml
24 Operational Transparency
0 Create-or-Update Ergonomics
Composite quality — 52.1/100 · developing
Agent readiness — 27/100 · agent aware
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 11
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 14
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
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
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 2
Portal, sign-up, and the first successful call
Documentation 1
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Build 1
SDKs, sample code, and the tooling you integrate with
Access & Security 5
Authentication, authorization, and security posture
Learn 1
Tutorials, courses, talks, and written guidance
Operate 2
Status, limits, changes, and where to get help
Commercial 3
Pricing, plans, and the legal terms of use
Company 7
The organization behind the API
Scroll for all 7
Other 1
Properties that don't map to a standard resource type
Source (apis.yml)
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:
- Webhook
- Event
- HR
tags_raw:
- 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:
- Authentication
tags_raw:
- 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
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
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: Producing
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
- 401k
- Time Off
- Compliance
- Small Business
- Employer of Record
- HRIS
tags_raw:
- 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.23'
Every provider here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for providers
9 MCP tools reach this
find_providersBrowse and filter every provider in the catalog. get_provider_artifactsEvery artifact this provider publishes, grouped by type. get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec. get_provider_toolsEvery MCP tool they ship, with the operation each wraps. get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it. get_provider_ratingPRO — composite, band, trend and facet scores. apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total. resolveTurn a domain, URL or GitHub org into the provider it belongs to. find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This provider
curl "https://apis.io/api/v1/providers/justworks"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/justworks/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/justworks/evidence"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.
Kin Score
How this is scored →