Sign in

v1

latestOpenAPI 3.0.1NamSorAPI_Lic_v0.0.72026-07-13115112157.9 KB
personal

[USES 10 UNITS PER NAME] Infer the likely country of origin of a personal name. Assumes names as they are in the country of origin. For US, CA, AU, NZ and other melting-pots : use 'diaspora' instead.

get/api2/json/origin/{firstName}/{lastName}

Path parameters

firstNamestring required
lastNamestring required

Response

A origined name.

scriptstring
idstring
explanationstring
firstNamestring

The first name (also known as given name)

lastNamestring

The last name (also known as family name, or surname)

countryOriginstring

Most likely country of Origin

countryOriginAltstring

Second best alternative : country of Origin

countriesOriginTopstring[]

List countries of Origin (top 10)

scorenumber double

Compatibility to NamSor_v1 Origin score value. Higher score is better, but score is not normalized. Use calibratedProbability if available.

regionOriginstring

Most likely region of Origin (based on countryOrigin ISO2 code)

topRegionOriginstring

Most likely top region of Origin (based on countryOrigin ISO2 code)

subRegionOriginstring

Most likely sub region of Origin (based on countryOrigin ISO2 code)

probabilityCalibratednumber double

The calibrated probability for countryOrigin to have been guessed correctly. -1 = still calibrating.

probabilityAltCalibratednumber double

The calibrated probability for countryOrigin OR countryOriginAlt to have been guessed correctly. -1 = still calibrating.