GET
/v1/paycheck/quick
Quick take-home estimate
The one-line version: what actually lands in the employee's account. Everything not supplied is defaulted, so this is an estimate - use POST /v1/paycheck for a real pay run.
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
gross |
number | required | Gross pay for one pay period. | 5000 |
frequency |
string | optional | weekly, biweekly, semimonthly or monthly. Defaults to biweekly. | semimonthly |
state |
string | optional | Two-letter work state. Defaults to TX. | CA |
filing_status |
string | optional | single_or_mfs, married_jointly or head_of_household. | single_or_mfs |
state_allowances |
integer | optional | Allowances or exemptions claimed on the state withholding certificate. | 1 |
Code samples
# Keep the key in the environment, not in your shell history:
# export GEOVERIO_API_KEY="gv_live_…"
curl --fail-with-body "https://payroll.geoverio.com/v1/paycheck/quick?gross=5000&frequency=semimonthly&state=CA&filing_status=single_or_mfs&state_allowances=1" \
-H "Authorization: Bearer $GEOVERIO_API_KEY"// Call this from your server, never from the browser:
// front-end JavaScript ships your key to every visitor.
const KEY = process.env.GEOVERIO_API_KEY;
async function main() {
const res = await fetch("https://payroll.geoverio.com/v1/paycheck/quick?gross=5000&frequency=semimonthly&state=CA&filing_status=single_or_mfs&state_allowances=1", {
headers: {
Authorization: `Bearer ${KEY}`
}
});
// Never parse the body before checking the status: an expired key answers
// 401 with a perfectly valid JSON envelope.
if (!res.ok) {
throw new Error(`HTTP ${res.status} — ${await res.text()}`);
}
console.log(await res.json());
}
main().catch((err) => {
console.error(err);
process.exitCode = 1;
});# pip install requests
import os, requests
url = "https://payroll.geoverio.com/v1/paycheck/quick?gross=5000&frequency=semimonthly&state=CA&filing_status=single_or_mfs&state_allowances=1"
headers = {"Authorization": "Bearer " + os.environ["GEOVERIO_API_KEY"]}
r = requests.get(url, headers=headers)
r.raise_for_status() # turns 4xx / 5xx into an exception instead of silent bad data
print(r.json())<?php
// Read the key from the server environment — never commit it.
$key = getenv('GEOVERIO_API_KEY');
$ch = curl_init("https://payroll.geoverio.com/v1/paycheck/quick?gross=5000&frequency=semimonthly&state=CA&filing_status=single_or_mfs&state_allowances=1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $key",
"Accept: application/json",
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
if ($status < 200 || $status >= 300) {
fwrite(STDERR, "Request failed — HTTP $status: $body\n");
exit(1);
}
print_r(json_decode($body, true));See a sample response
{
"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."
}