tools

find_tax_cliffs

Find exact dollar amounts where one more cent of an input costs MORE than a cent of tax (marginal rate over 100%) — e.g. the EITC investment-income kill switch, CTC phase-out steps. Every probe is a real evaluation.

post/v1/tools/find_tax_cliffs

Request

  • Base URL: https://opentax.invaro.ai
  • URL: https://opentax.invaro.ai/v1/tools/find_tax_cliffs
  • Auth: one of:
    • HTTP bearer
    • none

Headers

X-OpenTax-Return-Idstring

Your identifier for the taxpayer-year this call belongs to; the billing unit. Stored hashed.

Request body

factsobject required

facts for the computation: either flat corpus fact ids (see list_input_facts) or the same group objects calculate_tax accepts (filing, income, retirement, …), plus optional target and asOf. Business/fiduciary/dependent facts are accepted flat. Unknown keys are rejected by name — nothing is ever silently dropped.

varystring required

money fact to vary, e.g. "wages" or "taxableInterest"

fromDollarsnumber required
toDollarsnumber required
stepDollarsnumber

coarse scan step, default 1000

Response

ok:true with the computed value, line set or lookup hits; ok:false with error.code when the engine refuses (NEEDS_FACTS, NO_APPLICABLE_RULE, UNHANDLED_ENUM_CASE)

okboolean required

Changes

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