Skip to content
HALOWERK

Textwerk

fuzzy name match

Normalises names (NFKC, case, ICAO-style folding ä → ae, ø → oe, diacritics removed, & / und / and unified), detects legal-form suffixes from the GLEIF ISO 20275 Entity Legal Forms code list v1.6 for the chosen countries (default DE, AT, CH), lists the matching ELF entries and removes the suffix from the core name, removes academic titles and reorders "Surname, Given" for persons. Score = 0.35 token-sorted Levenshtein similarity + 0.25 Jaro-Winkler + 0.25 token Dice + 0.15 Dice of Cologne.

POST https://text.halowerk.com/v1/fuzzy-name-match

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
querystringYesName to look up.
candidatesarrayYesNames to compare with the query.
kindstringNocompany strips legal forms, person removes titles and handles "Surname, Given"; auto decides per name.
thresholdnumberNoScore from which is_match is true.
legal_form_countriesarrayNoISO 3166-1 countries whose ELF legal forms are recognised. US entries are per state and include generic words such as Co. and Ltd.
topintegerNoNumber of best candidates returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "query",
    "candidates"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Name to look up."
    },
    "candidates": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      },
      "description": "Names to compare with the query."
    },
    "kind": {
      "type": "string",
      "enum": [
        "auto",
        "company",
        "person",
        "generic"
      ],
      "default": "auto",
      "description": "company strips legal forms, person removes titles and handles \"Surname, Given\"; auto decides per name."
    },
    "threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.85,
      "description": "Score from which is_match is true."
    },
    "legal_form_countries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 60,
      "items": {
        "type": "string",
        "pattern": "^[A-Z]{2}$"
      },
      "default": [
        "DE",
        "AT",
        "CH"
      ],
      "description": "ISO 3166-1 countries whose ELF legal forms are recognised. US entries are per state and include generic words such as Co. and Ltd."
    },
    "top": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Number of best candidates returned."
    }
  }
}

Open original schema

Published input example

{
  "query": "Müller GmbH",
  "candidates": [
    "Mueller GmbH",
    "Möller AG",
    "Schmidt GmbH"
  ]
}

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 →