Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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 of theJustworks Partner API. Each item carries a partner-supplied operation_id for idempotency.

Justworks Deductions API is one of 11 APIs that Justworks publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Deductions, Payroll, and PEO. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 JSON Schema.

This API exposes 4 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 2026-05-25.

Requests are made against a single base URL, https://public-api.justworks.com.

4 operations 2 paths 4 schemas 1 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-05-25
Server
https://public-api.justworks.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Justworks Deductions API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 3 scopes. By default, every request must be authenticated.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 GET, 1 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Deductions 4

List, create, update, and cancel employee deductions

GET
/v1/deductions
Justworks List Deductions
listDeductions 6 params → 200
POST
/v1/deductions
Justworks Create Deductions
createDeductions body → 200
PUT
/v1/deductions
Justworks Update Deductions
updateDeductions body → 200
PATCH
/v1/deductions/cancel
Justworks Cancel Deductions
cancelDeductions body → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Deduction (10 properties), DeductionCreate (10 properties), DeductionUpdate (9 properties), DeductionWriteResult (1 property). Each schema is shown below with its type and property counts.

DeductionWriteResult
object
1 property
DeductionUpdate
object
9 properties 1 required
DeductionCreate
object
10 properties 8 required
Deduction
object
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

justworks-deductions-api-openapi.yml Raw ↑

Other APIs Justworks publishes across the network.

Justworks Members API
Justworks Company API
Justworks Webhooks API
Justworks OAuth API
Justworks Deduction Types API
Justworks Payrolls API
Justworks Paystubs API
Justworks Time Off Balances API
Justworks Time Off Policies API
Justworks Time Off Requests API