Skip to content
HALOWERK

Rechenwerk

installment plan

Simulates an instalment agreement: interest for each interval is open balance × annual rate × days / day basis (actual/365 by default or 30E/360), rounded to cents and paid first, the rest reduces the principal (§ 367(1) BGB order). With a fixed instalment the number of payments and the smaller final payment follow; with a given number of instalments the smallest cent amount that repays the debt in that number of payments is searched (bisection). Due dates step by whole months from the first.

POST https://rechen.halowerk.com/v1/installment-plan

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
principalnumberYesDebt at the start in EUR.
annual_ratenumberYesNominal interest rate in percent per year (0 for interest-free).
start_datestringYesDay from which interest runs (agreement date).
first_duestringYesDue date of the first instalment.
interval_monthsintegerNoMonths between instalments.
installmentnumberNoFixed instalment amount in EUR.
installments_countintegerNoNumber of instalments (instalment amount is computed).
day_countstringNoDay-count convention for interest.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "principal",
    "annual_rate",
    "start_date",
    "first_due"
  ],
  "properties": {
    "principal": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000,
      "description": "Debt at the start in EUR."
    },
    "annual_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "description": "Nominal interest rate in percent per year (0 for interest-free)."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Day from which interest runs (agreement date)."
    },
    "first_due": {
      "type": "string",
      "format": "date",
      "description": "Due date of the first instalment."
    },
    "interval_months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "default": 1,
      "description": "Months between instalments."
    },
    "installment": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000,
      "description": "Fixed instalment amount in EUR."
    },
    "installments_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 600,
      "description": "Number of instalments (instalment amount is computed)."
    },
    "day_count": {
      "type": "string",
      "enum": [
        "act_365",
        "30e_360"
      ],
      "default": "act_365",
      "description": "Day-count convention for interest."
    }
  }
}

Open original schema

Published input example

{
  "principal": 1200,
  "annual_rate": 6,
  "start_date": "2026-01-01",
  "first_due": "2026-02-01",
  "installment": 400
}

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 →