Invoke Skill Tax Quarterly Estimate

post/api/v1/skills/tax.quarterly.estimate/invoke

Advisory — LLM-driven; verify against authoritative sources before relying. Calculate a US federal quarterly estimated tax payment under one of the three IRC §6654/§6655 safe harbor rules (prior-year, annualised, or current-year). Read-only — outputs a worksheet with cumulative-required tracking and underpayment risk flag.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`tax_year`required	`string`	Tax year, e.g. '2026'.
`quarter`required	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	— `Q1Q2Q3Q4`
`entity_type`	`"individual" \| "corporation" \| "s_corporation" \| "partnership" \| "trust"`	— `individualcorporations_corporationpartnershiptrust`
`safe_harbor_method`	`"prior_year" \| "annualised" \| "current_year"`	— `prior_yearannualisedcurrent_year`
`prior_year_tax`	`number \| string \| null`	If known; otherwise the handler reads from prior-year TB.
`current_ytd_income`	`number \| string \| null`	Override for current-year YTD income (skips TB read).
`tax_jurisdiction`	`string`	US-federal (IRS) by default. State-level extensions use US-{state} codes (e.g. US-CA for California Form 540-ES).

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`artifact_id`	`string (uuid) \| null`	—
`download_url`	`string`	—
`summary`	`string`	—
`citations`	`any[]`	—
`warnings`	`string[]`	—
`stub_fields`	`string[]`	—
`estimate_amount`	`number \| string`	—
`cumulative_required`	`number \| string`	Running sum of payments required YTD through this quarter.
`safe_harbor_basis`	`"prior_year" \| "annualised" \| "current_year"`	— `prior_yearannualisedcurrent_year`
`due_date`	`string (date) \| null`	—
`irs_form`	`string`	The IRS form applicable, e.g. '1040-ES' (individuals), '1120-W' (corp).
`breakdown`	`object`	Line-item working — prior-year tax, safe-harbor pct, quarterly target. show nested Empty object.
`underpayment_risk`	`"none" \| "low" \| "medium" \| "high"`	— `nonelowmediumhigh`

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/tax.quarterly.estimate/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "tax_year": "string",
       "quarter": "Q1",
       "entity_type": "individual",
       "safe_harbor_method": "prior_year",
       "prior_year_tax": null,
       "current_ytd_income": null,
       "tax_jurisdiction": "string"
     }'