Skip to content
HALOWERK

Rechenwerk

tax deadlines

VAT advance return due on the 10th day after the period (§ 18(1) UStG; monthly if previous-year VAT > 9,000 EUR, else quarterly; exemption possible up to 2,000 EUR, § 18(2)), extended by one month on application (§ 46 UStDV) with a special prepayment of 1/11 of last year prepayments for monthly filers (§§ 47, 48 UStDV). Wage tax return on the 10th day after the period (§ 41a EStG: month above 5,000 EUR, quarter above 1,080 EUR, else year). EC sales list on the 25th day (§ 18a UStG). Annual.

POST https://rechen.halowerk.com/v1/tax-deadlines

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
kindstringYesType of return.
yearintegerYesCalendar year of the tax period.
period_typestringNoFiling period; if omitted it is derived from previous_year_tax (VAT and wage tax).
period_numberintegerNoMonth (1-12) or quarter (1-4); omit to list the whole year.
previous_year_taxnumberNoVAT or wage tax of the previous year in EUR, to derive the filing period.
permanent_extensionbooleanNoVAT permanent extension (Dauerfristverlängerung, § 46 UStDV).
previous_year_prepaymentsnumberNoSum of last year VAT prepayments in EUR (monthly filers with extension: special prepayment 1/11).
statestringNoGerman federal state whose public holidays apply (e.g. NW, BY, BE). If omitted, only nationwide holidays are used and states with a different result are listed.
regionstringNoOptional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities (Assumption Day), EVANG; SN BZ=Bautzen; TH EIC, UH, WAK.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "kind",
    "year"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "vat_advance_return",
        "wage_tax_return",
        "ec_sales_list",
        "annual_return"
      ],
      "description": "Type of return."
    },
    "year": {
      "type": "integer",
      "minimum": 2020,
      "maximum": 2098,
      "description": "Calendar year of the tax period."
    },
    "period_type": {
      "type": "string",
      "enum": [
        "month",
        "quarter",
        "year"
      ],
      "description": "Filing period; if omitted it is derived from previous_year_tax (VAT and wage tax)."
    },
    "period_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month (1-12) or quarter (1-4); omit to list the whole year."
    },
    "previous_year_tax": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000,
      "description": "VAT or wage tax of the previous year in EUR, to derive the filing period."
    },
    "permanent_extension": {
      "type": "boolean",
      "default": false,
      "description": "VAT permanent extension (Dauerfristverlängerung, § 46 UStDV)."
    },
    "previous_year_prepayments": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000000,
      "description": "Sum of last year VAT prepayments in EUR (monthly filers with extension: special prepayment 1/11)."
    },
    "state": {
      "type": "string",
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "German federal state whose public holidays apply (e.g. NW, BY, BE). If omitted, only nationwide holidays are used and states with a different result are listed."
    },
    "region": {
      "type": "string",
      "enum": [
        "A",
        "KATH",
        "EVANG",
        "BZ",
        "EIC",
        "UH",
        "WAK"
      ],
      "description": "Optional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities (Assumption Day), EVANG; SN BZ=Bautzen; TH EIC, UH, WAK."
    }
  }
}

Open original schema

Published input example

{
  "kind": "vat_advance_return",
  "year": 2026,
  "period_type": "quarter",
  "permanent_extension": true,
  "state": "BW"
}

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 →