Skip to content
HALOWERK

Textwerk

easy language check

Implements the machine-checkable rules of "Die Regeln für Leichte Sprache" (Netzwerk Leichte Sprache e.V., 2022 edition) as heuristics and reports each finding with rule number, excerpt and offset: difficult, technical and foreign words (OpenThesaurus register labels, LGPL/CC BY-SA), long words with a hyphenated split, abbreviations, nominal style, passive, genitive, subjunctive, negation, idioms, Roman numerals, old years, large numbers and percentages, number words, date format, special.

POST https://text.halowerk.com/v1/easy-language-check

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text; line breaks are used for rule G5.
max_sentence_wordsintegerNoSentence length limit for rule S1 (the rulebook gives no number; 12 is a service default).
long_word_lettersintegerNoWords with at least this many letters and no hyphen are reported under W5.
reference_yearintegerNoYear used to decide which year numbers are "old" (Z2: more than 100 years before). Default: current year.
allowed_abbreviationsarrayNoAbbreviations your reviewers accept (W6). The rulebook examples WC, LKW, Dr. and ICE are always accepted.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50000,
      "description": "German text; line breaks are used for rule G5."
    },
    "max_sentence_words": {
      "type": "integer",
      "minimum": 3,
      "maximum": 40,
      "default": 12,
      "description": "Sentence length limit for rule S1 (the rulebook gives no number; 12 is a service default)."
    },
    "long_word_letters": {
      "type": "integer",
      "minimum": 6,
      "maximum": 40,
      "default": 12,
      "description": "Words with at least this many letters and no hyphen are reported under W5."
    },
    "reference_year": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2200,
      "description": "Year used to decide which year numbers are \"old\" (Z2: more than 100 years before). Default: current year."
    },
    "allowed_abbreviations": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 20
      },
      "description": "Abbreviations your reviewers accept (W6). The rulebook examples WC, LKW, Dr. and ICE are always accepted."
    }
  }
}

Open original schema

Published input example

{
  "text": "Der Antrag wird von der Behörde genehmigt, weil die Unterlagen vollständig sind.\nDas ist z. B. nicht unwichtig."
}

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 →