Name check

Check one name

Says whether a name typed into a sign-up or lead form looks like a real person's name, and why. It catches keyboard mashing ("asdf qwerty"), placeholders ("Test Test", "John Doe", "n/a"), fictional characters ("Mickey Mouse"), profanity, digits, symbols and email addresses in the name field. One credit per name.

It never calls a name fake. The answer is an assessment (plausible, suspicious or implausible), a score from 0 to 100 and the signals behind it. Use it to flag a record or ask for more information, not to reject people automatically.

Real names that trip simpler filters are left alone: surnames such as Null, Test or Cockburn, two-letter names such as Ng, single names, and every script we cannot read. A first name found in official birth records raises the score; a name we have never seen does not lower it on its own. Surnames are judged by their shape only, because there is no surname dataset behind this endpoint.

get/api/v1/name-check

Request

  • Base URL: https://namegender.com
  • URL: https://namegender.com/api/v1/name-check
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Query parameters

namestring

The name as typed into the form. Send this or first_name/last_name.

first_namestring
last_namestring
countrystring

Country hint, as on the gender endpoints. Used for name parsing and for the record lookup.

localestring
ipstring

Response

Checked.

credits_chargedinteger
credits_remaininginteger
data_versionstring nullable
request_idstring
country_source'country' | 'locale' | 'ip' | 'null' nullable
querystring
assessment'plausible' | 'suspicious' | 'implausible'

implausible: at least one high-severity signal. suspicious: a medium signal or two low ones. Otherwise plausible.

scoreinteger

Higher is more like a real name. For your own threshold.

first_namestring nullable
last_namestring nullable
name_type'personal' | 'organization' | 'role'

Changes

No recorded changes to this operation across all 1 revision of this API.