Skip to content
HALOWERK

Finopswerk

estimated tax installment credit ledger

Reconstructs a conditional regular four-installment estimated-tax credit ledger. Annual requirement = min(90% current tax, prior tax * (110% if prior AGI > USD 150000 else 100%)), a quarter per installment. Withholding and estimated payments are credited to the oldest installment first; excess carries forward. Returns 13 4-slot fraction arrays. The remaining balance is not a penalty or tax bill. The caller establishes the applicable 2025 individual regular method.

POST https://finops.halowerk.com/v1/estimated-tax-installment-credit-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
prior_tax_centsintegerYes
prior_agi_centsintegerYes
current_tax_domain_centsarrayYes
annual_withholding_centsintegerYes
estimated_payments_centsarrayYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "prior_tax_cents": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "prior_agi_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50000000
    },
    "current_tax_domain_cents": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 1000000
      },
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true
    },
    "annual_withholding_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "estimated_payments_cents": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 4,
      "maxItems": 4
    },
    "report": {
      "type": "object",
      "minProperties": 13,
      "maxProperties": 13,
      "propertyNames": {
        "enum": [
          "prior_multiplier",
          "annual_required",
          "quarter_required",
          "withholding_credit",
          "estimated_credit",
          "carry_forward",
          "due_1",
          "due_2",
          "due_3",
          "due_4",
          "total_outstanding",
          "cumulative_credits",
          "credit_gap"
        ]
      },
      "additionalProperties": {
        "type": "array",
        "minItems": 4,
        "maxItems": 4,
        "items": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "n",
            "d"
          ],
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            }
          }
        }
      }
    }
  },
  "required": [
    "prior_tax_cents",
    "prior_agi_cents",
    "current_tax_domain_cents",
    "annual_withholding_cents",
    "estimated_payments_cents",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "prior_tax_cents": 1,
  "prior_agi_cents": 10000000,
  "current_tax_domain_cents": [
    1
  ],
  "annual_withholding_cents": 1,
  "estimated_payments_cents": [
    0,
    0,
    0,
    0
  ],
  "report": {
    "prior_multiplier": [
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      }
    ],
    "annual_required": [
      {
        "n": "9",
        "d": "10"
      },
      {
        "n": "9",
        "d": "10"
      },
      {
        "n": "9",
        "d": "10"
      },
      {
        "n": "9",
        "d": "10"
      }
    ],
    "quarter_required": [
      {
        "n": "9",
        "d": "40"
      },
      {
        "n": "9",
        "d": "40"
      },
      {
        "n": "9",
        "d": "40"
      },
      {
        "n": "9",
        "d": "40"
      }
    ],
    "withholding_credit": [
      {
        "n": "1",
        "d": "4"
      },
      {
        "n": "1",
        "d": "4"
      },
      {
        "n": "1",
        "d": "4"
      },
      {
        "n": "1",
        "d": "4"
      }
    ],
    "estimated_credit": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "carry_forward": [
      {
        "n": "1",
        "d": "40"
      },
      {
        "n": "1",
        "d": "20"
      },
      {
        "n": "3",
        "d": "40"
      },
      {
        "n": "1",
        "d": "10"
      }
    ],
    "due_1": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "due_2": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "due_3": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "due_4": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "total_outstanding": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "cumulative_credits": [
      {
        "n": "1",
        "d": "4"
      },
      {
        "n": "1",
        "d": "2"
      },
      {
        "n": "3",
        "d": "4"
      },
      {
        "n": "1",
        "d": "1"
      }
    ],
    "credit_gap": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      }
    ]
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’