{"uid":"cap_zACk-d9SKfTppchkMnaPP","slug":"us-take-home-paycheck-estimator-08ab9e61","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://api.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_PLU6i3Ru83hmI2gqD0Fd2","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":"Estimates US net take-home pay per period by computing federal income tax, payroll tax, and optional state tax from gross income and filing details.","exampleAgentPrompt":"What will my biweekly take-home pay be if I earn $85,000 a year, file as single, live in California, and contribute $5,000 annually to my 401k for tax year 2026?","exampleUseCases":null,"resultDescription":"Returns estimated net pay per pay period, total federal income tax, payroll tax (Social Security and Medicare), optional state tax estimate, and disposable income — all computed from the provided inputs, with no persistent state or tax advice.","failureModes":["Missing required gross_income parameter returns a 400 validation error","Invalid state code (not a valid US two-letter abbreviation) may return an error or fall back to federal-only calculation","Negative gross_income value rejected by schema validation","Invalid filing_status enum value returns a 400 error","Invalid pay_period enum value returns a 400 error","Payment not provided or insufficient USDC returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a fast, pure-computation estimate of US take-home pay broken down by federal income tax, payroll tax, and optional state tax — especially when you have gross income, filing status, and optionally pretax deductions like 401k contributions. Prefer this over general tax APIs when you specifically need per-period net pay figures (weekly, biweekly, monthly, etc.) rather than annual tax filing calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:51:52.720Z","isFirstParty":false}