medianfi-com · Schema

PrivateTaxPlanScenarioResponse

FinanceBookkeepingArtificial IntelligenceStartupsAccounting

Properties

Name Type Description
success boolean
data object
View JSON Schema on GitHub

JSON Schema

medianfi-com-private-tax-plan-scenario-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/medianfi-com/json-schema/medianfi-com-private-tax-plan-scenario-response-schema.json",
  "title": "PrivateTaxPlanScenarioResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/medianfi-com-companies-api-openapi.yml#/components/schemas/PrivateTaxPlanScenarioResponse",
  "type": "object",
  "required": [
    "success",
    "data"
  ],
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "data": {
      "type": "object",
      "required": [
        "revision",
        "state",
        "result"
      ],
      "properties": {
        "revision": {
          "type": "integer",
          "minimum": 1
        },
        "state": {
          "$ref": "#/$defs/PrivateTaxPlanScenario"
        },
        "result": {
          "$ref": "#/$defs/PrivateTaxPlanCalculation"
        }
      }
    }
  },
  "$defs": {
    "PrivateTaxPlanCalculation": {
      "type": "object",
      "required": [
        "values",
        "year",
        "payments",
        "withholdingMethod",
        "debtExcluded",
        "funding",
        "fundingRemaining",
        "remainingOwnerWages"
      ],
      "properties": {
        "values": {
          "type": "object",
          "additionalProperties": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "year": {
          "type": "integer"
        },
        "payments": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "agency",
              "year",
              "liabilityCents",
              "withholdingCents",
              "appliedCents",
              "catchUpCents",
              "additionalCents",
              "balanceCents",
              "rows"
            ],
            "properties": {
              "agency": {
                "type": "string"
              },
              "year": {
                "type": "integer"
              },
              "liabilityCents": {
                "type": "integer",
                "minimum": 0
              },
              "withholdingCents": {
                "type": "integer",
                "minimum": 0
              },
              "appliedCents": {
                "type": "integer",
                "minimum": 0
              },
              "catchUpCents": {
                "type": "integer",
                "minimum": 0
              },
              "additionalCents": {
                "type": "integer",
                "minimum": 0
              },
              "balanceCents": {
                "type": "integer"
              },
              "rows": {
                "type": "array",
                "minItems": 4,
                "maxItems": 4,
                "items": {
                  "type": "object",
                  "required": [
                    "date",
                    "amountCents"
                  ],
                  "properties": {
                    "date": {
                      "type": "string",
                      "format": "date"
                    },
                    "amountCents": {
                      "type": "integer",
                      "minimum": 0
                    }
                  }
                }
              }
            }
          }
        },
        "withholdingMethod": {
          "type": "string",
          "enum": [
            "salary-estimate",
            "entered-total",
            "actual-and-remaining"
          ]
        },
        "debtExcluded": {
          "type": "number",
          "minimum": 0
        },
        "health": {
          "type": "object",
          "required": [
            "credit",
            "repayment",
            "deduction"
          ],
          "properties": {
            "credit": {
              "type": "number",
              "minimum": 0
            },
            "repayment": {
              "type": "number",
              "minimum": 0
            },
            "deduction": {
              "type": "number",
              "minimum": 0
            }
          }
        },
        "funding": {
          "type": "object",
          "required": [
            "employee",
            "employer",
            "unclassified",
            "priorYearCash",
            "rollover"
          ],
          "properties": {
            "employee": {
              "type": "number",
              "minimum": 0
            },
            "employer": {
              "type": "number",
              "minimum": 0
            },
            "unclassified": {
              "type": "number",
              "minimum": 0
            },
            "priorYearCash": {
              "type": "number",
              "minimum": 0
            },
            "rollover": {
              "type": "number",
              "minimum": 0
            }
          }
        },
        "fundingRemaining": {
          "type": "object",
          "required": [
            "employee",
            "employer"
          ],
          "properties": {
            "employee": {
              "type": "number",
              "minimum": 0
            },
            "employer": {
              "type": "number",
              "minimum": 0
            }
          }
        },
        "remainingOwnerWages": {
          "type": "number",
          "minimum": 0
        }
      }
    },
    "PrivateTaxPlanScenario": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "scenarioId",
        "inputs",
        "payments",
        "withholding"
      ],
      "properties": {
        "scenarioId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 150
        },
        "inputs": {
          "type": "object",
          "propertyNames": {
            "maxLength": 100
          },
          "additionalProperties": {
            "type": "number",
            "minimum": -1000000000,
            "maximum": 1000000000
          }
        },
        "health": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "year",
            "householdSize",
            "otherMagi",
            "months"
          ],
          "properties": {
            "year": {
              "type": "integer",
              "minimum": 2026,
              "maximum": 2027
            },
            "householdSize": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            },
            "otherMagi": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000
            },
            "months": {
              "type": "array",
              "minItems": 12,
              "maxItems": 12,
              "items": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "premium",
                  "benchmark",
                  "advance",
                  "eligible",
                  "deductible"
                ],
                "properties": {
                  "premium": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "benchmark": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "advance": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "eligible": {
                    "type": "boolean"
                  },
                  "deductible": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "debt": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "year",
            "discharged",
            "gross",
            "liabilities",
            "assets"
          ],
          "properties": {
            "year": {
              "type": "integer",
              "minimum": 2020,
              "maximum": 2100
            },
            "discharged": {
              "type": "boolean"
            },
            "gross": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000
            },
            "liabilities": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000
            },
            "assets": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000
            }
          }
        },
        "funding": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "year",
              "paidDate",
              "type",
              "amount"
            ],
            "properties": {
              "year": {
                "type": "integer",
                "minimum": 2020,
                "maximum": 2100
              },
              "paidDate": {
                "type": "string",
                "format": "date",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "type": {
                "type": "string",
                "enum": [
                  "employee",
                  "employer",
                  "rollover",
                  "unclassified"
                ]
              },
              "amount": {
                "type": "number",
                "minimum": 0,
                "maximum": 1000000000
              }
            }
          }
        },
        "payments": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "agency",
              "year",
              "date",
              "amountCents",
              "status"
            ],
            "properties": {
              "agency": {
                "type": "string",
                "enum": [
                  "federal-personal",
                  "state-personal",
                  "nyc-ubt",
                  "nyc-gct",
                  "nys-ptet",
                  "nyc-ptet"
                ]
              },
              "year": {
                "type": "integer",
                "minimum": 2020,
                "maximum": 2100
              },
              "date": {
                "type": "string",
                "format": "date",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              "amountCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000000000
              },
              "status": {
                "type": "string",
                "enum": [
                  "paid",
                  "planned"
                ]
              }
            }
          }
        },
        "withholding": {
          "type": "object",
          "propertyNames": {
            "pattern": "^20\\d{2}$"
          },
          "additionalProperties": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "mode",
              "federalCents",
              "stateCents",
              "wagesPaidCents",
              "federalPaidCents"
            ],
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "salary-estimate",
                  "entered-total",
                  "actual-and-remaining"
                ]
              },
              "federalCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000000000
              },
              "stateCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000000000
              },
              "wagesPaidCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000000000
              },
              "federalPaidCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000000000
              }
            }
          }
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/medianfi-com-private-tax-plan-scenario-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.