Skip to content
HALOWERK

Rechenwerk

pension points

For each year: capped earnings = min(earnings, annual contribution ceiling x months/12) using Anlage 2 (West) or 2a (East, until 2024); East earnings until 2024 are multiplied by the Anlage 10 conversion value; earning points = capped earnings / average earnings of the year (Anlage 1; 2025 and 2026 provisional per § 69/§ 70(1) sentence 2), rounded to four decimals (§ 121 SGB VI). The monthly pension value = points x current pension value (RWBestV 2023-2026, 37.60/39.32/40.79/42.52 EUR from 1.

POST https://rechen.halowerk.com/v1/pension-points

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
entriesarrayYes
pension_value_datestringNoDate for the current pension value (default: latest published value from 2026-07-01).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "entries"
  ],
  "properties": {
    "entries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 60,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "year",
          "earnings"
        ],
        "properties": {
          "year": {
            "type": "integer",
            "minimum": 1950,
            "maximum": 2100,
            "description": "Calendar year of the earnings (2002 to 2026 supported)."
          },
          "earnings": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Insured gross earnings of the year in EUR (contribution base; in the Übergangsbereich the actual pay, § 70(1a) SGB VI)."
          },
          "months": {
            "type": "integer",
            "minimum": 1,
            "maximum": 12,
            "default": 12,
            "description": "Months insured in the year; the contribution ceiling is pro-rated."
          },
          "region": {
            "type": "string",
            "enum": [
              "west",
              "east"
            ],
            "default": "west",
            "description": "east = employment in the accession area (Beitrittsgebiet) until 2024; from 2025 one ceiling applies."
          }
        }
      }
    },
    "pension_value_date": {
      "type": "string",
      "format": "date",
      "description": "Date for the current pension value (default: latest published value from 2026-07-01)."
    }
  }
}

Open original schema

Published input example

{
  "entries": [
    {
      "year": 2024,
      "earnings": 47085
    },
    {
      "year": 2026,
      "earnings": 60000
    }
  ]
}

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 →