Skip to content
HALOWERK

Textwerk

umlaut restore

Every word containing ae, oe, ue or ss is compared with about 145,000 German full forms with umlauts or ß from the LanguageTool part-of-speech dictionary german-pos-dict 1.2.2 (Morphy, CC BY-SA 4.0). A word is only changed when it is not itself a valid form and exactly one dictionary form matches (fewest added ß preferred, so dass/muss/Fluss stay). Valid words with a valid umlaut twin (Masse/Maße) are kept and reported as ambiguous. Unknown compounds are split into dictionary parts.

POST https://text.halowerk.com/v1/umlaut-restore

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text with transcribed umlauts, e.g. "Gruesse aus Muenchen".
variantstringNode-CH keeps ss (no ß in Swiss spelling); de-DE and de-AT restore ß.
include_unresolvedbooleanNoList words with transcriptions that matched no dictionary form (names, foreign words).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50000,
      "description": "German text with transcribed umlauts, e.g. \"Gruesse aus Muenchen\"."
    },
    "variant": {
      "type": "string",
      "enum": [
        "de-DE",
        "de-AT",
        "de-CH"
      ],
      "default": "de-DE",
      "description": "de-CH keeps ss (no ß in Swiss spelling); de-DE and de-AT restore ß."
    },
    "include_unresolved": {
      "type": "boolean",
      "default": true,
      "description": "List words with transcriptions that matched no dictionary form (names, foreign words)."
    }
  }
}

Open original schema

Published input example

{
  "text": "Viele Gruesse aus Muenchen und schoene Feiertage!"
}

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 →