Rechenwerk
claim statement
Runs a ledger from the interest start dates to the statement date: default interest per claim (base rate table of the Deutsche Bundesbank as of 2026-10-30 plus § 288 points) accrues on the open principal only (§ 289: no interest on interest, no interest on costs) and is rounded to cents at each payment and at the statement date. Each payment is credited first to costs, then interest, then principal (§ 367(1) BGB), or costs, principal, interest for consumer loans (§ 497(3)); across several.
POST https://rechen.halowerk.com/v1/claim-statementInputs
| Field | Type | Required | Description |
|---|---|---|---|
| claims | array | Yes | |
| costs | array | No | |
| payments | array | No | |
| as_of | string | Yes | Statement date; interest runs up to and including this day. |
| rate_type | string | No | 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). |
| allocation | string | No | bgb_367: costs, interest, principal (§ 367(1) BGB); consumer_credit_497: costs, principal, interest (§ 497(3) BGB). |
| day_count | string | No | Day-count convention: act_365 (default, common for default interest), act_act, act_360, 30e_360. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"claims",
"as_of"
],
"properties": {
"claims": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"amount"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Claim reference."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"description": "Principal in EUR."
},
"interest_from": {
"type": "string",
"format": "date",
"description": "First day of default interest (inclusive); omit for no interest."
},
"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)."
}
}
}
},
"costs": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"amount"
],
"properties": {
"description": {
"type": "string",
"maxLength": 200,
"description": "e.g. reminder fee, court fee."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"description": "Cost amount in EUR (not interest-bearing)."
},
"date": {
"type": "string",
"format": "date",
"description": "Date the cost arose (for ordering)."
}
}
}
},
"payments": {
"type": "array",
"maxItems": 500,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"date",
"amount"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "Date the payment was credited."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"description": "Payment in EUR."
}
}
}
},
"as_of": {
"type": "string",
"format": "date",
"description": "Statement date; interest runs up to and including this day."
},
"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)."
},
"allocation": {
"type": "string",
"enum": [
"bgb_367",
"consumer_credit_497"
],
"default": "bgb_367",
"description": "bgb_367: costs, interest, principal (§ 367(1) BGB); consumer_credit_497: costs, principal, interest (§ 497(3) BGB)."
},
"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."
}
}
}Published input example
{
"claims": [
{
"id": "RE-1",
"amount": 1000,
"interest_from": "2026-01-01"
}
],
"costs": [
{
"description": "reminder fee",
"amount": 10
}
],
"payments": [
{
"date": "2026-02-01",
"amount": 500
}
],
"as_of": "2026-03-31"
}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
- Rechenwerk0.003 USDC
ai act risk class
POSThttps://rechen.halowerk.com/v1/ai-act-risk-classEvaluates the caller’s description against Regulation (EU) 2024/1689 as amended by Regulation (EU) 2026/1744: prohibited practices of Art. 5(1)(a)-(h) and the new points (ba) and (bb) (from 2 December 2026); high-risk under Art. 6(1) (safet
- Rechenwerk0.002 USDC
annuity schedule
POSThttps://rechen.halowerk.com/v1/annuity-scheduleMonthly 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, t
- Rechenwerk0.002 USDC
appeal deadlines
POSThttps://rechen.halowerk.com/v1/appeal-deadlinesCovers only clearly codified periods: Berufung one month and grounds two months (§§ 517, 520(2) ZPO), Revision one and two months (§§ 548, 551(2) ZPO), labour court appeal (§ 66(1) ArbGG), all starting with service of the complete judgment