Skip to content
HALOWERK

Rechenwerk

default interest

Computes default interest for each day from start_date to end_date (both inclusive) on a principal: base rate (§ 247 BGB, Deutsche Bundesbank table 2002-01-01 to 2026-12-31, as of 2026-10-30) plus 5 points (§ 288(1)), 9 points for payment claims without consumer (§ 288(2)), 8 points for obligations arising before 29 July 2014 (Art. 229 § 34 EGBGB) or 2.5 points for real-estate consumer loans (§ 497(4)). Each half-year segment = principal × rate × days / day basis with the chosen convention.

POST https://rechen.halowerk.com/v1/default-interest

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
principalnumberYesOutstanding principal in EUR.
start_datestringYesFirst day of default interest (inclusive), usually the day after the due date or the day default began.
end_datestringYesLast day of default interest (inclusive), e.g. the day before payment was credited.
rate_typestringNoconsumer = § 288(1) BGB (+5 points, a consumer is involved or not a payment claim); business = § 288(2) BGB (+9 points, payment claim without consumer); real_estate_consumer_loan = § 497(4) BGB (+2.5 points).
obligation_datestringNoDate the obligation arose; for business claims before 29 July 2014 the old 8-point rate applies.
day_countstringNoDay-count convention: act_365 (default, common for default interest), act_act, act_360, 30e_360.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "principal",
    "start_date",
    "end_date"
  ],
  "properties": {
    "principal": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000000000,
      "description": "Outstanding principal in EUR."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "First day of default interest (inclusive), usually the day after the due date or the day default began."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Last day of default interest (inclusive), e.g. the day before payment was credited."
    },
    "rate_type": {
      "type": "string",
      "enum": [
        "consumer",
        "business",
        "real_estate_consumer_loan"
      ],
      "default": "consumer",
      "description": "consumer = § 288(1) BGB (+5 points, a consumer is involved or not a payment claim); business = § 288(2) BGB (+9 points, payment claim without consumer); real_estate_consumer_loan = § 497(4) BGB (+2.5 points)."
    },
    "obligation_date": {
      "type": "string",
      "format": "date",
      "description": "Date the obligation arose; for business claims before 29 July 2014 the old 8-point rate applies."
    },
    "day_count": {
      "type": "string",
      "enum": [
        "act_365",
        "act_act",
        "act_360",
        "30e_360"
      ],
      "default": "act_365",
      "description": "Day-count convention: act_365 (default, common for default interest), act_act, act_360, 30e_360."
    }
  }
}

Open original schema

Published input example

{
  "principal": 1000,
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "rate_type": "consumer"
}

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 →