Skip to content
HALOWERK

Rechenwerk

annuity schedule

Monthly annuity in arrears as used by German banks: rate = loan × (nominal rate + initial repayment rate) / 12, or from a term via A = L·q^n·(q−1)/(q^n−1) with q = 1 + i/12; interest each month = balance × i/12 (30/360), rounded to cents, the rest repays principal; the last payment clears the balance. Optional special repayments at month ends. Returns the first months, yearly or monthly schedule, residual debt after the fixed-rate period (Zinsbindung), payoff month and total interest. Pure.

POST https://rechen.halowerk.com/v1/annuity-schedule

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
loan_amountnumberYesLoan amount in EUR.
nominal_ratenumberYesNominal interest rate (Sollzins) in percent per year.
initial_repayment_ratenumberNoInitial repayment in percent of the loan per year (anfängliche Tilgung).
term_monthsintegerNoFull repayment term in months (alternative to initial_repayment_rate).
fixed_rate_yearsintegerNoFixed-rate period in years for the residual debt.
special_repaymentsarrayNo
granularitystringNoSchedule rows per loan year or per month (monthly limited to 600 rows).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "loan_amount",
    "nominal_rate"
  ],
  "properties": {
    "loan_amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000,
      "description": "Loan amount in EUR."
    },
    "nominal_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 30,
      "description": "Nominal interest rate (Sollzins) in percent per year."
    },
    "initial_repayment_rate": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Initial repayment in percent of the loan per year (anfängliche Tilgung)."
    },
    "term_months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1200,
      "description": "Full repayment term in months (alternative to initial_repayment_rate)."
    },
    "fixed_rate_years": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Fixed-rate period in years for the residual debt."
    },
    "special_repayments": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "month",
          "amount"
        ],
        "properties": {
          "month": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1200,
            "description": "Loan month (1 = first month) at whose end the special repayment is made."
          },
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 10000000000,
            "description": "Special repayment in EUR."
          }
        }
      }
    },
    "granularity": {
      "type": "string",
      "enum": [
        "yearly",
        "monthly"
      ],
      "default": "yearly",
      "description": "Schedule rows per loan year or per month (monthly limited to 600 rows)."
    }
  }
}

Open original schema

Published input example

{
  "loan_amount": 100000,
  "nominal_rate": 3.6,
  "initial_repayment_rate": 2,
  "fixed_rate_years": 10
}

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 →