Skip to content

Name Check

Validate names, detect salutation/gender, identify real vs. fake names, detect organizations.

Method: nameCheck

API KeyNot set

Stored in localStorage — never sent to this site.

Parameters
Request Preview
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "nameCheck",
  "params": {}
}
Set an API key above to enable live requests.

Parameters

FieldRequiredTypeDescription
salutationYesStringSee salutation codes below
firstNameYesStringFirst name
lastNameYesStringLast name
titleNoStringAcademic title (e.g. Dr.)
countryCodeNoStringISO country code
languageNoStringOutput language (default: de)

Salutation Codes

CodeMeaning
mMale
fFemale
dDiverse
xUnknown (could be m or f)
sFamily
oOrganization

Response

json
{
  "result": {
    "predictions": [
      {
        "salutation": "m",
        "firstName": "Max",
        "lastName": "Mustermann"
      }
    ],
    "score": 0.95,
    "status": [
      "name_is_natural_person",
      "name_correct"
    ]
  }
}

Status Codes

CodeMeaning
name_correctName is valid
name_needs_correctionCorrected name in predictions
name_not_foundName not found in database
salutation_needs_correctionDetected gender differs from submitted salutation
name_is_natural_personDetected as a real person's name
name_is_familyDetected as a family name
name_is_organisationDetected as an organization
name_is_realName appears genuine
name_is_probably_fakeName may be fictitious
name_is_fakeName is known fictitious (e.g. Max Mustermann)
name_has_placeholderPlaceholder name detected
name_transpositionedFirst and last name appear swapped

Example

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "nameCheck",
  "params": {
    "countryCode": "de",
    "language": "de",
    "salutation": "m",
    "firstName": "Florian",
    "lastName": "Müller"
  }
}

Endereco JSON-RPC API