Skip to content
HALOWERK

Rechenwerk

per diem

Per travel day: full day (24 h absence) or arrival/departure day or single day over 8 hours; domestic 28 / 14 EUR (§ 9(4a) sentence 3 EStG), abroad the 2026 rates of 166 countries and city entries (BMF letter of 5 Dec 2025, IV C 5 - S 2353/00094/007/012, BStBl I 2025, 2078; unlisted countries use Luxembourg, Micronesia the Philippines, the Trinidad consular district Trinidad). Meals provided by the employer reduce the day amount by 20 % (breakfast) and 40 % (lunch, dinner) of the full-day.

POST https://rechen.halowerk.com/v1/per-diem

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
daysarrayYesTravel days in 2026.
assignment_startstringNoStart of a longer-term activity at the same place (three-month rule).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "days"
  ],
  "properties": {
    "days": {
      "type": "array",
      "minItems": 1,
      "maxItems": 366,
      "description": "Travel days in 2026.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Calendar date in 2026 (optional; needed for the three-month check)."
          },
          "kind": {
            "type": "string",
            "enum": [
              "full_day",
              "arrival_departure",
              "single_day_over_8h"
            ],
            "description": "full_day = 24 h absence; arrival_departure = day of arrival or departure of a trip with overnight stay; single_day_over_8h = no overnight stay, more than 8 hours absence."
          },
          "country": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "default": "DE",
            "description": "ISO 3166-1 alpha-2 code or German country name as in the BMF table (DE = domestic)."
          },
          "place": {
            "type": "string",
            "maxLength": 80,
            "description": "City with its own rate (e.g. London, New York City); otherwise the \"im Übrigen\" rate applies."
          },
          "breakfast": {
            "type": "boolean",
            "default": false,
            "description": "Breakfast provided by or on behalf of the employer."
          },
          "lunch": {
            "type": "boolean",
            "default": false,
            "description": "Lunch provided."
          },
          "dinner": {
            "type": "boolean",
            "default": false,
            "description": "Dinner provided."
          },
          "meal_payment": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000,
            "default": 0,
            "description": "Amount the employee paid for the provided meals of this day (reduces the cut)."
          },
          "overnight": {
            "type": "boolean",
            "default": false,
            "description": "Overnight stay abroad on this day (shows the overnight flat rate for employer reimbursement)."
          }
        }
      }
    },
    "assignment_start": {
      "type": "string",
      "format": "date",
      "description": "Start of a longer-term activity at the same place (three-month rule)."
    }
  }
}

Open original schema

Published input example

{
  "days": [
    {
      "date": "2026-03-02",
      "kind": "arrival_departure",
      "country": "GB",
      "place": "London"
    },
    {
      "date": "2026-03-03",
      "kind": "full_day",
      "country": "GB",
      "place": "London",
      "breakfast": true,
      "overnight": true
    },
    {
      "date": "2026-03-04",
      "kind": "arrival_departure",
      "country": "GB",
      "place": "London",
      "breakfast": true
    }
  ]
}

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 →