Skip to content
HALOWERK

Formatwerk

retention periods

For each document the service applies the legal categories of § 147 Abs. 1 AO and § 257 Abs. 1 HGB and, for invoices, § 14b UStG: books, inventories, annual statements, management reports, opening balance sheets and organisational documents 10 years; booking vouchers and invoices 8 years; business letters and other tax-relevant documents 6 years; customs documents (Art. 15/163 UCC) 10 years; delivery notes that are not booking vouchers until the invoice is received or sent. The period starts.

POST https://format.halowerk.com/v1/retention-periods

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
documentsarrayYesDocuments to evaluate.
entitystringNocredit_or_financial_institution = institutions under § 1 Abs. 1b KWG, insurers under § 1 Abs. 1 VAG, investment firms under § 2 Abs. 1 WpIG.
merchantbooleanNoMerchant (Kaufmann) under the HGB; false = only tax law applies.
reference_datestringNoDate for the "may be destroyed" answer, default today (UTC).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "documents"
  ],
  "properties": {
    "documents": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "description": "Documents to evaluate.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "category",
          "date"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100,
            "description": "Your reference."
          },
          "category": {
            "type": "string",
            "enum": [
              "books_and_records",
              "inventories",
              "opening_balance_sheet",
              "annual_financial_statements",
              "management_report",
              "consolidated_statements",
              "work_instructions_and_organisation_documents",
              "booking_vouchers",
              "invoices",
              "received_business_letters",
              "sent_business_letter_copies",
              "customs_documents",
              "other_tax_relevant_documents",
              "delivery_notes_not_vouchers"
            ],
            "description": "Legal category: books_and_records, inventories, opening_balance_sheet, annual_financial_statements, management_report, consolidated_statements, work_instructions_and_organisation_documents, booking_vouchers, invoices, received_business_letters, sent_business_letter_copies, customs_documents, other_tax_relevant_documents, delivery_notes_not_vouchers."
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Event date: last entry, preparation/adoption, receipt or dispatch, creation of the voucher, invoice date."
          },
          "invoice_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Delivery notes only: date the related invoice was received or sent."
          }
        }
      }
    },
    "entity": {
      "type": "string",
      "enum": [
        "general",
        "credit_or_financial_institution"
      ],
      "default": "general",
      "description": "credit_or_financial_institution = institutions under § 1 Abs. 1b KWG, insurers under § 1 Abs. 1 VAG, investment firms under § 2 Abs. 1 WpIG."
    },
    "merchant": {
      "type": "boolean",
      "default": true,
      "description": "Merchant (Kaufmann) under the HGB; false = only tax law applies."
    },
    "reference_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date for the \"may be destroyed\" answer, default today (UTC)."
    }
  }
}

Open original schema

Published input example

{
  "documents": [
    {
      "id": "ER-2026-118",
      "category": "invoices",
      "date": "2026-03-15"
    },
    {
      "category": "annual_financial_statements",
      "date": "2025-04-30"
    }
  ]
}

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 →