Raw schema
{
"type": "object",
"properties": {
"gross_amount_eur": {
"type": "number",
"minimum": 1,
"maximum": 2000000,
"description": "Gross pay in euros, before any deduction."
},
"gross_period": {
"type": "string",
"enum": [
"year",
"month"
],
"description": "Whether gross_amount_eur is an annual or a monthly figure."
},
"tax_class": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"description": "German Steuerklasse. 1 single, 2 single parent, 3 married higher earner, 4 married equal earners, 5 married lower earner, 6 second and further jobs."
},
"bundesland": {
"type": "string",
"enum": [
"BW",
"BY",
"BE",
"BB",
"HB",
"HH",
"HE",
"MV",
"NI",
"NW",
"RP",
"SL",
"SN",
"ST",
"SH",
"TH"
],
"description": "Federal state the person lives in, as its two-letter code. Sets the church-tax rate (8 percent in BY and BW, 9 percent elsewhere). For employees in statutory insurance it also sets the Saxony care-insurance split; civil servants pay the same half care rate in every state."
},
"church_tax": {
"default": false,
"description": "Whether the person is liable for church tax.",
"type": "boolean"
},
"child_allowances": {
"default": 0,
"description": "Kinderfreibetrag count (ZKF), in steps of 0.5. Each parent normally carries 0.5 per child; a single claimant carries 1.0 per child. This is not the number of children.",
"type": "number",
"minimum": 0,
"maximum": 20,
"multipleOf": 0.5
},
"children_for_care_insurance": {
"description": "Number of children under 25 for the care-insurance reduction. Counted separately from child_allowances because the two rules differ. Treated as 0 for employees when omitted; required for a civil servant in statutory insurance.",
"type": "integer",
"minimum": 0,
"maximum": 10
},
"childless_over_23": {
"description": "Whether the person is 23 or older and has no children, which adds the care-insurance surcharge. Treated as false for employees when omitted; required for a civil servant in statutory insurance.",
"type": "boolean"
},
"health_insurance": {
"default": "statutory",
"description": "Statutory (gesetzlich) or private (privat) health insurance.",
"type": "string",
"enum": [
"statutory",
"private"
]
},
"statutory_additional_rate_percent": {
"default": 2.9,
"description": "The health fund's Zusatzbeitrag in percent. 2.9 is the 2026 average and is used when the user does not know theirs. Only applies with statutory insurance.",
"type": "number",
"minimum": 0,
"maximum": 5
},
"private_health_premium_eur_per_month": {
"description": "Monthly private health premium (Krankenversicherung) in euros for basic cover, as on the insurer's contribution statement, greater than 0. Required when health_insurance is 'private'. For an employee, the full premium before the employer subsidy; the subsidy is computed and only the employee's share is deducted. For a civil servant, the amount paid after Beihilfe, for health and care together unless private_care_premium_eur_per_month is passed.",
"type": "number",
"minimum": 0,
"maximum": 3000
},
"private_care_premium_eur_per_month": {
"description": "Monthly private care premium (Pflegepflichtversicherung) in euros, as on the insurer's contribution statement. Only used when health_insurance is 'private'. For an employee the employer pays half of it up to its own cap; when it is omitted, private_health_premium_eur_per_month counts as health cover only. For a civil servant it is added to the premium paid after Beihilfe.",
"type": "number",
"minimum": 0,
"maximum": 1000
},
"employment": {
"default": "employee",
"description": "'employee' for employees in the statutory pension scheme. 'civil_servant' for Beamte: no pension or unemployment contributions. With private insurance the premium paid after Beihilfe is deducted; with statutory insurance the full health contribution at the reduced rate plus the full Zusatzbeitrag and care insurance at the half rate for Beihilfe recipients.",
"type": "string",
"enum": [
"employee",
"civil_servant"
]
},
"year": {
"default": 2026,
"description": "Tax year. Only 2026 is implemented.",
"type": "number",
"const": 2026
}
},
"required": [
"gross_amount_eur",
"gross_period",
"tax_class",
"bundesland"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}