Skip to content
HALOWERK

Textwerk

imprint draft

Builds an imprint in Markdown and plain text with the items of § 5 Abs. 1 DDG (version 2026-03-25): name and address, legal form and authorised representatives, e-mail and a second fast contact channel, supervisory authority, register with number, regulated professions, VAT ID (§ 27a UStG, check digit verified with ISO 7064 MOD 11,10) or business ID, and the responsible person under § 18 Abs. 2 MStV. Lists every mandatory item missing for the chosen legal form.

POST https://text.halowerk.com/v1/imprint-draft

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
legal_formstringYesLegal form.
namestringYesFull name or company name including legal form suffix.
addressobjectYes
representativesarrayNoAuthorised representatives (managing directors, board, partners).
emailstringYes
phonestringNo
contact_form_urlstringNo
registerobjectNo
vat_idstringNoGerman VAT ID (USt-IdNr.).
business_idstringNoWirtschafts-Identifikationsnummer.
supervisory_authoritystringNoAuthority for activities that need a licence.
professionobjectNo
capitalobjectNoOnly if capital is stated at all.
in_liquidationbooleanNo
editorialobjectNoJournalistic-editorial content: responsible person (§ 18 Abs. 2 MStV).
journalisticbooleanNoThe site offers journalistic-editorial content.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "legal_form",
    "name",
    "address",
    "email"
  ],
  "properties": {
    "legal_form": {
      "type": "string",
      "enum": [
        "sole_trader",
        "registered_merchant",
        "freelancer",
        "gbr",
        "ohg",
        "kg",
        "gmbh_co_kg",
        "partg",
        "gmbh",
        "ug",
        "ag",
        "kgaa",
        "eg",
        "ev"
      ],
      "description": "Legal form."
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 160,
      "description": "Full name or company name including legal form suffix."
    },
    "address": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "street",
        "postcode",
        "city"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Name or company."
        },
        "addition": {
          "type": "string",
          "maxLength": 120,
          "description": "Optional second address line (department, c/o)."
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Street and house number."
        },
        "postcode": {
          "type": "string",
          "pattern": "^[0-9A-Z -]{3,10}$",
          "description": "Postcode."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "City."
        },
        "country": {
          "type": "string",
          "maxLength": 60,
          "description": "Country, only for addresses abroad."
        }
      }
    },
    "representatives": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 120
      },
      "description": "Authorised representatives (managing directors, board, partners)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 120
    },
    "phone": {
      "type": "string",
      "maxLength": 40
    },
    "contact_form_url": {
      "type": "string",
      "format": "uri"
    },
    "register": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "court",
        "type",
        "number"
      ],
      "properties": {
        "court": {
          "type": "string",
          "minLength": 2,
          "maxLength": 80,
          "description": "Register court, e.g. \"Amtsgericht Coesfeld\"."
        },
        "type": {
          "type": "string",
          "enum": [
            "HRA",
            "HRB",
            "GnR",
            "PR",
            "VR",
            "GsR"
          ]
        },
        "number": {
          "type": "string",
          "pattern": "^[0-9]{1,7}( ?[A-Z]{1,3})?$"
        }
      }
    },
    "vat_id": {
      "type": "string",
      "pattern": "^DE[0-9]{9}$",
      "description": "German VAT ID (USt-IdNr.)."
    },
    "business_id": {
      "type": "string",
      "pattern": "^DE[0-9]{9}-[0-9]{5}$",
      "description": "Wirtschafts-Identifikationsnummer."
    },
    "supervisory_authority": {
      "type": "string",
      "maxLength": 200,
      "description": "Authority for activities that need a licence."
    },
    "profession": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "title",
        "state",
        "chamber"
      ],
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 80
        },
        "state": {
          "type": "string",
          "maxLength": 60
        },
        "chamber": {
          "type": "string",
          "maxLength": 160
        },
        "rules": {
          "type": "array",
          "maxItems": 10,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 160
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      }
    },
    "capital": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "amount"
      ],
      "properties": {
        "amount": {
          "type": "number",
          "minimum": 0
        },
        "outstanding": {
          "type": "number",
          "minimum": 0
        }
      },
      "description": "Only if capital is stated at all."
    },
    "in_liquidation": {
      "type": "boolean",
      "default": false
    },
    "editorial": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "address"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 120
        },
        "address": {
          "type": "string",
          "maxLength": 200
        }
      },
      "description": "Journalistic-editorial content: responsible person (§ 18 Abs. 2 MStV)."
    },
    "journalistic": {
      "type": "boolean",
      "default": false,
      "description": "The site offers journalistic-editorial content."
    }
  }
}

Open original schema

Published input example

{
  "legal_form": "gmbh",
  "name": "Lagertechnik Nord GmbH",
  "address": {
    "street": "Hallenweg 1",
    "postcode": "48599",
    "city": "Gronau"
  },
  "representatives": [
    "Mietpartei Nord"
  ],
  "email": "api@halowerk.com",
  "phone": "+49 2562 0000",
  "register": {
    "court": "Amtsgericht Coesfeld",
    "type": "HRB",
    "number": "12345"
  },
  "vat_id": "DE123456788"
}

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 →