Justworks

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
  - type: NaftikoCapability
    url: capabilities/members.yaml
  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
  - type: NaftikoCapability
    url: capabilities/company.yaml
  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-payroll-api
  name: Justworks Payroll API
  tags:
  - Payroll
  - PEO
  - Paystubs
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-payroll-api-openapi.yml
    type: OpenAPI
  - url: json-schema/justworks-payroll-schema.json
    type: JSONSchema
  - url: json-schema/justworks-paystub-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/payroll.yaml
  description: |
    Read payroll runs, fees, and paystubs. Each payroll record summarizes gross pay, net pay, employee
    and employer taxes, and debit information; paystubs break down per-member earnings, employee
    deductions, and employer contributions. Monetary fields are zero-decimal integers.

- 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
  - type: NaftikoCapability
    url: capabilities/deductions.yaml
  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-time-off-api
  name: Justworks Time Off API
  tags:
  - Time Off
  - PTO
  - Leave
  - HR
  humanURL: https://public-api.justworks.com/v1/docs
  properties:
  - url: https://public-api.justworks.com/v1/docs
    type: Documentation
  - url: openapi/justworks-time-off-api-openapi.yml
    type: OpenAPI
  - url: json-schema/justworks-time-off-request-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/time-off.yaml
  description: |
    Manage time-off balances, policies, and requests. Balance reports are asynchronous — submit a
    POST, then poll the report endpoint until ready. Policies and requests are paginated reads with
    standard cursor semantics.

- 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
  - type: NaftikoCapability
    url: capabilities/webhooks.yaml
  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.

common:
- 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: PartnerIntegrations
  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
position: Provider
access: 3rd-Party
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
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: [email protected]
  X: apievangelist
  url: https://apievangelist.com
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'