Certaa · v1 · US Payroll Tax API

The payroll tax engine built for everyone building payroll.

Real-time gross-to-net calculation across federal, all 50 states, DC and local jurisdictions. A modern REST API with public pricing and no lock-in.

POST /v1/calculateIllustrative sample
{
  "calculationId": "calc_01j9x2mzk4…",
  "grossPay":       "5000.00",
  "netPay":         "3521.48",
  "totalTaxWithheld": "1478.52",
  "employeeTaxes": [
    { "taxType": "federal_income",   "amount": "568.42",
      "jurisdiction": "US" },
    { "taxType": "state_income",     "amount": "218.76",
      "jurisdiction": "US-CA" },
    { "taxType": "social_security",  "amount": "310.00" },
    { "taxType": "medicare",         "amount": "72.50" },
    { "taxType": "state_disability", "amount": "55.00",
      "jurisdiction": "US-CA-SDI" }
  ],
  "appliedJurisdictions": ["US","US-CA","US-CA-SDI"],
  "metadata": {
        "ratesAsOf": "2026-01-01",
    "ruleSnapshot": "snap_20260101"
  }
}
51States + DC
FederalPlus state and local rules
RESTJSON API
AuditTrail on every calculation
Capabilities

Everything you need to run payroll taxes.

The full federal + state + local tax stack, delivered as a clean REST API you actually want to integrate.

Core

Gross-to-Net Engine

Real-time federal, state, and local tax calculation for any employee type — W-2, NRA, FICA-exempt, supplemental wages, and gross-up.

Jurisdictions

Full Local Tax Coverage

PA Act 32 PSD codes, OH and KY municipal, AL occupational taxes, NY MCTMT, OR Metro SHS and more local regimes alongside federal and all 50 states plus DC.

Compliance

Automated Rule Updates

Tax rules monitored and updated as governments publish changes. Pin a rule snapshot with X-Rule-Snapshot for deterministic reproducibility.

Developer

REST API + OpenAPI Spec

Clean JSON in, clean JSON out. Full OpenAPI 3.0 specification and a Postman collection. No SOAP, no XML.

Infrastructure

Audit Trail

Every calculation logged with the exact rule version, jurisdiction set, and inputs used. Full audit trail for compliance and dispute resolution.

Advanced

Simulation & Gross-Up

Calculate net from gross or gross from a desired net. Run jurisdiction simulations before processing payroll. Batch up to 1,000 employees per call.

How it works

One API call. Complete payroll taxes.

01

Send one HTTP request

Pass the employee pay data, W-4 elections, work address, and pay period to /v1/calculate.

02

Engine resolves jurisdictions

We geocode the work address and automatically apply every applicable federal, state, and local tax rule.

03

Receive a complete paycheck

Get back net pay, itemized withholdings, jurisdiction list, source citations, and processing metadata.

Capabilities at a glance

What you get.

What Certaa provides today.

FeatureCertaa
API architectureREST / JSON + OpenAPI 3.0
PricingPublic plan pricing via GET /v1/pricing
Source citationsRule citations in responses
Rule snapshotsPin a rule date with X-Rule-Snapshot
NRA / visa worker supportYes
Pay stubsJSON + printable HTML
Get started free

Start calculating in 60 seconds.

Create your account and get a live API key. No credit card, no sales call.

Get API key →