{"uid":"cap_yZ4zqRPL3IO0lXgHlvLbn","slug":"us-take-home-paycheck-estimator-0c8313f1","name":"US Take-Home Paycheck Estimator","description":"US take-home paycheck estimate: federal income tax plus payroll tax and an optional state estimate, giving net pay per period and disposable income. Pure computation over your inputs, not tax advice.","url":"https://payai.agentstools.dev/tax/paycheck","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["gross_income"],"properties":{"state":{"type":"string","description":"Optional two-letter state code"},"tax_year":{"type":"integer","description":"Tax year, default 2026"},"pay_period":{"enum":["annual","monthly","semimonthly","biweekly","weekly"],"type":"string","description":"Pay period for the per-period figures, default annual"},"gross_income":{"type":"number","description":"Annual gross income (>= 0)"},"filing_status":{"enum":["single","married_jointly","married_separately","head_of_household"],"type":"string","description":"Filing status, default single"},"pretax_deductions":{"type":"number","description":"Annual pretax deductions such as 401k, default 0"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zL3hEHv7lIidcPsrkisOq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes estimated US net take-home pay per period by calculating federal income tax, payroll tax, and optional state tax from gross income and filing details.","exampleAgentPrompt":"What will my take-home pay be each biweekly paycheck if I earn $95,000 a year, file as single, live in Texas, and contribute $6,000 a year to my 401k?","exampleUseCases":[{"title":"New job offer salary comparison","prompt":"I just got a job offer for $130,000 a year in New York. I'm single and plan to put $10,000 into my 401k. What will my monthly take-home pay actually be after federal and state taxes?"},{"title":"Married couple paycheck planning","prompt":"My spouse and I file jointly and our combined gross income is $180,000 a year. Can you estimate our biweekly net pay after taxes for 2026, assuming we're in Colorado and have $15,000 in pretax deductions?"},{"title":"Freelancer annual disposable income check","prompt":"I'm self-employed and expect to earn about $75,000 this year. I file as single with no pretax deductions and live in Florida. What's my estimated annual take-home pay after federal income and payroll taxes?"}],"resultDescription":"Returns estimated net pay for the specified pay period after federal income tax and payroll (FICA) tax deductions, with an optional state tax estimate when a state code is provided. Also includes annual disposable income and a breakdown of each tax component applied to the gross income.","failureModes":["Missing required gross_income parameter returns a 400 validation error","Invalid state code returns an error or falls back to federal-only calculation","Unsupported filing_status enum value returns a validation error","Negative gross_income value rejected with a validation error","Invalid pay_period enum value causes a 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need a fast, pure-computation paycheck estimate for US employees without calling a full tax filing service. It is ideal for salary negotiation tools, financial planning agents, and compensation comparison workflows where you need net pay broken down by period. Prefer it over general tax APIs when you specifically need per-period net pay figures including FICA payroll taxes and optional state estimates, and when you do not need full tax return preparation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:57.478Z","isFirstParty":false}