Tax

Estimated-tax / §6654 safe-harbor + underpayment-penalty estimate

Evaluates the §6654 estimated-tax safe harbors for an individual and estimates the underpayment penalty if the safe harbor is missed — for anyone with lumpy or under-withheld income (equity comp, business owners, Roth converters). The required annual payment is the lesser of 90% of the current year's tax or the prior-year safe harbor (100% of last year's tax, or 110% when prior-year AGI exceeds $150,000 / $75,000 MFS). No penalty applies if the balance due after withholding is under $1,000, or the prior year had zero tax. The penalty is estimated with the regular method (four equal installments, withholding credited evenly, overpayments carried forward) at the IRS underpayment rate — 7% for 2025 and 2026 by default, overridable per request since the penalty accrues into a year whose quarterly rates are unpublished. Deterministic; not tax advice.

post/v1/tax/estimated-tax

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/tax/estimated-tax
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

tax_yearinteger required

Current tax year. Must be 2025 or 2026 unless underpayment_rate is supplied.

filing_status'single' | 'mfj' | 'mfs' | 'hoh' required
prior_year_taxnumber required

Total tax on the prior-year return (the prior-year safe-harbor base).

prior_year_aginumber required

Prior-year AGI; over $150,000 ($75,000 MFS) raises the prior-year harbor to 110%.

projected_current_taxnumber required

Expected total tax for the current year.

withholdingnumber required

Expected withholding this year (credited evenly across the four installments).

estimated_paymentsnumber[]

The four quarterly estimated payments (Q1..Q4); omit or zero any not yet paid.

underpayment_ratenumber

Optional; overrides the assumed annual IRS underpayment rate (e.g. 0.08). Omit to use the year's default (7% for 2025/2026).

Response

The safe-harbor evaluation and penalty estimate

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "esttax_1a2b3c4d5e6f7a8b",
  "engine_version": "estimated-tax-1.0.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.