About this API
Federal, state and local payroll withholding for a single paycheck or a whole pay run. Send earnings, W-4 data and year-to-date figures; get every tax and deduction, net pay, updated year-to-date, a render-ready pay statement, and the items the employee's state legally requires on a wage statement. Nothing is stored and nothing is filed - the numbers and the compliance metadata are the product.
GET https://payroll.geoverio.com/v1/paycheck/quick
{
"meta": {
"tax_year": 2026,
"data_version": "2026.1",
"tables_effective_on": "2026-01-01",
"module_version": "0.2.0",
"disclaimer": "Calculated estimates for record-keeping. Not tax advice. Geoverio does not file or remit taxes and does not verify any figure supplied by the caller."
},
"gross": 5000,
"net_pay": 3503.56,
"taxes": [
{
"code": "federal_income_tax",
"label": "Federal Income Tax",
"amount": 732
},
{
"code": "social_security",
"label": "Social Security",
"amount": 310
},
{
"code": "medicare",
"label": "Medicare",
"amount": 72.5
},
{
"code": "ca_income_tax",
"label": "California Income Tax",
"amount": 316.94
},
{
"code": "ca_sdi",
"label": "CA SDI",
"amount": 65
}
],
"effective_tax_rate": 29.93,
"jurisdiction": {
"code": "CA",
"name": "California",
"status": "supported",
"method": "ca_method_b",
"effective_from": "2026-01-01",
"effective_to": null,
"source": {
"name": "California Withholding Schedules for 2026 - Method B, Exact Calculation (EDD)",
"url": "https:\/\/edd.ca.gov\/siteassets\/files\/pdf_pub_ctr\/26methb.pdf",
"retrieved": "2026-08-31",
"verified_by": "Golden tests reproduce the publication's annualized worked examples E and F."
}
},
"warnings": [
{
"code": "jurisdiction_note",
"severity": "info",
"message": "California taxes HSA contributions - they reduce federal wages but not California wages."
}
],
"note": "An estimate with default assumptions. POST \/v1\/paycheck for a real pay run."
}
Send your key as Authorization: Bearer <your key>.
The full parameter list for this endpoint is in the
reference.