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
| Field | Required | Type | Description |
|---|---|---|---|
salutation | Yes | String | See salutation codes below |
firstName | Yes | String | First name |
lastName | Yes | String | Last name |
title | No | String | Academic title (e.g. Dr.) |
countryCode | No | String | ISO country code |
language | No | String | Output language (default: de) |
Salutation Codes
| Code | Meaning |
|---|---|
m | Male |
f | Female |
d | Diverse |
x | Unknown (could be m or f) |
s | Family |
o | Organization |
Response
json
{
"result": {
"predictions": [
{
"salutation": "m",
"firstName": "Max",
"lastName": "Mustermann"
}
],
"score": 0.95,
"status": [
"name_is_natural_person",
"name_correct"
]
}
}Status Codes
| Code | Meaning |
|---|---|
name_correct | Name is valid |
name_needs_correction | Corrected name in predictions |
name_not_found | Name not found in database |
salutation_needs_correction | Detected gender differs from submitted salutation |
name_is_natural_person | Detected as a real person's name |
name_is_family | Detected as a family name |
name_is_organisation | Detected as an organization |
name_is_real | Name appears genuine |
name_is_probably_fake | Name may be fictitious |
name_is_fake | Name is known fictitious (e.g. Max Mustermann) |
name_has_placeholder | Placeholder name detected |
name_transpositioned | First 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"
}
}