Skip to content
HALOWERK

Textwerk

grammar check de

Runs the open-source LanguageTool 6.8 rule engine (LGPL-2.1) on a local server for de-DE, de-AT or de-CH: Morfologik spell checking, several thousand XML grammar rules and Java rules for agreement, compounds, case, commas and typography. Returns every match with offset, length, message, up to five replacements, rule id and category, counts per category and optionally a text with the first suggestion applied. The free rule set without n-gram data is used, so confusion pairs that need.

POST https://text.halowerk.com/v1/grammar-check-de

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text to check (plain text, up to 20,000 characters).
variantstringNoLanguage variant: Germany, Austria or Switzerland (de-CH uses ss instead of ß).
levelstringNopicky additionally enables LanguageTool style and typography rules.
disabled_rulesarrayNoLanguageTool rule ids to switch off, e.g. GERMAN_SPELLER_RULE.
apply_suggestionsbooleanNoAlso return the text with the first suggestion of every non-style match applied (overlapping matches skipped).
max_matchesintegerNoMaximum number of matches returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "German text to check (plain text, up to 20,000 characters)."
    },
    "variant": {
      "type": "string",
      "enum": [
        "de-DE",
        "de-AT",
        "de-CH"
      ],
      "default": "de-DE",
      "description": "Language variant: Germany, Austria or Switzerland (de-CH uses ss instead of ß)."
    },
    "level": {
      "type": "string",
      "enum": [
        "default",
        "picky"
      ],
      "default": "default",
      "description": "picky additionally enables LanguageTool style and typography rules."
    },
    "disabled_rules": {
      "type": "array",
      "maxItems": 50,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9_]{2,80}$"
      },
      "description": "LanguageTool rule ids to switch off, e.g. GERMAN_SPELLER_RULE."
    },
    "apply_suggestions": {
      "type": "boolean",
      "default": false,
      "description": "Also return the text with the first suggestion of every non-style match applied (overlapping matches skipped)."
    },
    "max_matches": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 200,
      "description": "Maximum number of matches returned."
    }
  }
}

Open original schema

Published input example

{
  "text": "Das ist ein Fehller. Er ist seid gestern krank.",
  "variant": "de-DE"
}

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 →