Skip to content
HALOWERK

Finopswerk

ira distribution conversion basis ledger

Reconstructs the 2025 allocation of traditional IRA after-tax basis between non-conversion distributions and Roth conversions from six caller-qualified USD cent amounts: prior basis, 2025 nondeductible contributions, their after-year subset, the Dec 31, 2025 IRA value, the distribution and the net Roth conversion. Returns 24 exact fractions with nontaxable and taxable amounts and remaining basis. Aggregates all traditional/SEP/SIMPLE IRAs of one individual.

POST https://finops.halowerk.com/v1/ira-distribution-conversion-basis-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
prior_basis_centsintegerYes
current_nondeductible_centsintegerYes
afteryear_contribution_centsintegerYes
yearend_value_centsintegerYes
distribution_centsintegerYes
conversion_centsintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "prior_basis_cents",
    "current_nondeductible_cents",
    "afteryear_contribution_cents",
    "yearend_value_cents",
    "distribution_cents",
    "conversion_cents",
    "report"
  ],
  "properties": {
    "prior_basis_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "current_nondeductible_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "afteryear_contribution_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "yearend_value_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "distribution_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "conversion_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "prior_basis",
          "current_nondeductible",
          "afteryear_contributions",
          "total_basis",
          "available_basis",
          "yearend_value",
          "nonconversion_distribution",
          "conversion",
          "denominator",
          "ratio",
          "ratio_millionths",
          "basis_nontaxable_distribution",
          "basis_nontaxable_conversion",
          "basis_used",
          "taxable_distribution",
          "taxable_conversion",
          "taxable_total",
          "remaining_basis",
          "excluded_afteryear_basis",
          "allocation_branch",
          "distribution_gap",
          "conversion_gap",
          "basis_gap",
          "total_taxable_reconciliation_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "n",
          "d"
        ],
        "properties": {
          "n": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          },
          "d": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          }
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "prior_basis_cents": 2000,
  "current_nondeductible_cents": 3000,
  "afteryear_contribution_cents": 1000,
  "yearend_value_cents": 6000,
  "distribution_cents": 2000,
  "conversion_cents": 2000,
  "report": {
    "prior_basis": {
      "n": "2000",
      "d": "1"
    },
    "current_nondeductible": {
      "n": "3000",
      "d": "1"
    },
    "afteryear_contributions": {
      "n": "1000",
      "d": "1"
    },
    "total_basis": {
      "n": "5000",
      "d": "1"
    },
    "available_basis": {
      "n": "4000",
      "d": "1"
    },
    "yearend_value": {
      "n": "6000",
      "d": "1"
    },
    "nonconversion_distribution": {
      "n": "2000",
      "d": "1"
    },
    "conversion": {
      "n": "2000",
      "d": "1"
    },
    "denominator": {
      "n": "10000",
      "d": "1"
    },
    "ratio": {
      "n": "2",
      "d": "5"
    },
    "ratio_millionths": {
      "n": "400000",
      "d": "1"
    },
    "basis_nontaxable_distribution": {
      "n": "800",
      "d": "1"
    },
    "basis_nontaxable_conversion": {
      "n": "800",
      "d": "1"
    },
    "basis_used": {
      "n": "1600",
      "d": "1"
    },
    "taxable_distribution": {
      "n": "1200",
      "d": "1"
    },
    "taxable_conversion": {
      "n": "1200",
      "d": "1"
    },
    "taxable_total": {
      "n": "2400",
      "d": "1"
    },
    "remaining_basis": {
      "n": "3400",
      "d": "1"
    },
    "excluded_afteryear_basis": {
      "n": "1000",
      "d": "1"
    },
    "allocation_branch": {
      "n": "1",
      "d": "1"
    },
    "distribution_gap": {
      "n": "0",
      "d": "1"
    },
    "conversion_gap": {
      "n": "0",
      "d": "1"
    },
    "basis_gap": {
      "n": "0",
      "d": "1"
    },
    "total_taxable_reconciliation_gap": {
      "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 โ†’