Sign in

v1

latestOpenAPI 3.0.1NamSorAPI_Lic_v0.0.72026-07-13115112157.9 KB
personal

[USES 10 UNITS PER NAME] Infer the likely origin of a name at a country subclassification level (state or regeion). Initially, this is only supported for India (ISO2 code 'IN').

get/api2/json/subclassification/{countryIso2}/{firstName}/{lastName}

Path parameters

countryIso2string required
firstNamestring required
lastNamestring required

Response

A classified name at a sub-country level.

scriptstring
idstring
explanationstring
firstNamestring

The first name (also known as given name)

lastNamestring

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

countryIso2string

The input country ISO2 code

subClassificationstring

Most likely subclassification ISO_3166-2 code

subClassificationAltstring

Second best alternative : subclassification ISO_3166-2 code

subclassificationTopstring[]

List subclassification ISO_3166-2 codes (top 10)

scorenumber double

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

probabilityCalibratednumber double

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

probabilityAltCalibratednumber double

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