# NamSor API v2 API

> NamSor API v2 API on Apizie: 88 endpoints (Activate/deactivate anonymization for a source., Read API Key info., List of classification services and usage cost in Units per classification (default is 1=ONE Unit). Some API…, Prints the current status of the classifiers. A classifier name in apiStatus corresponds to a service name…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/ai:namsor/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:namsor`
- Category: Artificial Intelligence
- Status: byok
- Source: http://www.namsor.com/
- Page: https://zieapi.vercel.app/api/ai/namsor
- OpenAPI: https://zieapi.vercel.app/api/ai/namsor/openapi.json

NamSor API v2 : enpoints to process personal names (gender, cultural origin or ethnicity) in all alphabets or languages. By default, enpoints use 1 unit per name (ex. Gender), but Ethnicity classification uses 10 to 20…

## Endpoints

### Activate/deactivate anonymization for a source.
`GET https://zieapi.vercel.app/v1/ai:namsor/anonymize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | yes |  |
| anonymized | boolean | yes |  |
| token | string | yes |  |

### Read API Key info.
`GET https://zieapi.vercel.app/v1/ai:namsor/api-key-info` (byok)

### List of classification services and usage cost in Units per classification (default is 1=ONE Unit). Some API…
`GET https://zieapi.vercel.app/v1/ai:namsor/available-services` (byok)

### Prints the current status of the classifiers. A classifier name in apiStatus corresponds to a service name…
`GET https://zieapi.vercel.app/v1/ai:namsor/api-status` (byok)

### Print current API usage.
`GET https://zieapi.vercel.app/v1/ai:namsor/api-usage` (byok)

### Print historical API usage.
`GET https://zieapi.vercel.app/v1/ai:namsor/api-usage-history` (byok)

### Print historical API usage (in an aggregated view, by service, by day/hour/min).
`GET https://zieapi.vercel.app/v1/ai:namsor/api-usage-history-aggregate` (byok)

### [USES 10 UNITS PER NAME] Infer the likely Indian name castegroup of a personal full name.
`GET https://zieapi.vercel.app/v1/ai:namsor/castegroup-indian-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subDivisionIso31662 | string | yes |  |
| personalNameFull | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely Indian name castegroup of up to 100 personal full names.
`POST https://zieapi.vercel.app/v1/ai:namsor/castegroup-indian-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Identify Chinese name candidates, based on the romanized name ex. Wang Xiaoming
`GET https://zieapi.vercel.app/v1/ai:namsor/chinese-name-candidates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseSurnameLatin | string | yes |  |
| chineseGivenNameLatin | string | yes |  |

### Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName;…
`POST https://zieapi.vercel.app/v1/ai:namsor/chinese-name-candidates-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName;…
`POST https://zieapi.vercel.app/v1/ai:namsor/chinese-name-candidates-gender-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Identify Chinese name candidates, based on the romanized name ex. Wang Xiaoming - having a known gender…
`GET https://zieapi.vercel.app/v1/ai:namsor/chinese-name-gender-candidates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseSurnameLatin | string | yes |  |
| chineseGivenNameLatin | string | yes |  |
| knownGender | string | yes |  |

### Return a score for matching Chinese name ex. 王晓明 with a romanized name ex. Wang Xiaoming
`GET https://zieapi.vercel.app/v1/ai:namsor/chinese-name-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseSurnameLatin | string | yes |  |
| chineseGivenNameLatin | string | yes |  |
| chineseName | string | yes |  |

### Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName;…
`POST https://zieapi.vercel.app/v1/ai:namsor/chinese-name-match-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 20 UNITS PER NAME COUPLE] Infer several classifications for a cross border interaction between names…
`GET https://zieapi.vercel.app/v1/ai:namsor/corridor` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryIso2From | string | yes |  |
| firstNameFrom | string | yes |  |
| lastNameFrom | string | yes |  |
| countryIso2To | string | yes |  |
| firstNameTo | string | yes |  |
| lastNameTo | string | yes |  |

### [USES 20 UNITS PER NAME PAIR] Infer several classifications for up to 100 cross border interaction between…
`POST https://zieapi.vercel.app/v1/ai:namsor/corridor-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely country of residence of a personal full name, or one surname.…
`GET https://zieapi.vercel.app/v1/ai:namsor/country` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| personalNameFull | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely country of residence of up to 100 personal full names, or…
`POST https://zieapi.vercel.app/v1/ai:namsor/country-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 20 UNITS PER NAME] Infer the likely ethnicity/diaspora of a personal name, given a country of…
`GET https://zieapi.vercel.app/v1/ai:namsor/diaspora` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryIso2 | string | yes |  |
| firstName | string | yes |  |
| lastName | string | yes |  |

### [USES 20 UNITS PER NAME] Infer the likely ethnicity/diaspora of up to 100 personal names, given a country of…
`POST https://zieapi.vercel.app/v1/ai:namsor/diaspora-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a just a fiven name, assuming default 'US' local context. Please use preferably…
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |

### Infer the likely gender of a name.
`GET https://zieapi.vercel.app/v1/ai:namsor/gender` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |

### Infer the likely gender of up to 100 names, detecting automatically the cultural context.
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a Chinese full name ex. 王晓明
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-chinese-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseName | string | yes |  |

### Infer the likely gender of up to 100 full names ex. 王晓明
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-chinese-name-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a Chinese name in LATIN (Pinyin).
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-chinese-name-pinyin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseSurnameLatin | string | yes |  |
| chineseGivenNameLatin | string | yes |  |

### Infer the likely gender of up to 100 Chinese names in LATIN (Pinyin).
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-chinese-name-pinyin-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a full name, ex. John H. Smith
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fullName | string | yes |  |

### Infer the likely gender of up to 100 full names, detecting automatically the cultural context.
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a full name, given a local context (ISO2 country code).
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-full-geo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fullName | string | yes |  |
| countryIso2 | string | yes |  |

### Infer the likely gender of up to 100 full names, with a given cultural context (country ISO2 code).
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-full-geo-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a name, given a local context (ISO2 country code).
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-geo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |
| countryIso2 | string | yes |  |

### Infer the likely gender of up to 100 names, each given a local context (ISO2 country code).
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-geo-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a Japanese name in LATIN (Pinyin).
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-japanese-name-pinyin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurname | string | yes |  |
| japaneseGivenName | string | yes |  |

### Infer the likely gender of up to 100 Japanese names in LATIN (Pinyin).
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-japanese-name-pinyin-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely gender of a Japanese full name ex. 王晓明
`GET https://zieapi.vercel.app/v1/ai:namsor/gender-japanese-name-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseName | string | yes |  |

### Infer the likely gender of up to 100 full names
`POST https://zieapi.vercel.app/v1/ai:namsor/gender-japanese-name-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Identify japanese name candidates in KANJI, based on the romanized name (firstName = japaneseGivenName;…
`POST https://zieapi.vercel.app/v1/ai:namsor/japanese-name-gender-kanji-candidates-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Identify japanese name candidates in KANJI, based on the romanized name ex. Yamamoto Sanae
`GET https://zieapi.vercel.app/v1/ai:namsor/japanese-name-kanji-candidates-1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurnameLatin | string | yes |  |
| japaneseGivenNameLatin | string | yes |  |

### Identify japanese name candidates in KANJI, based on the romanized name ex. Yamamoto Sanae - and a known…
`GET https://zieapi.vercel.app/v1/ai:namsor/japanese-name-kanji-candidates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurnameLatin | string | yes |  |
| japaneseGivenNameLatin | string | yes |  |
| knownGender | string | yes |  |

### Identify japanese name candidates in KANJI, based on the romanized name (firstName = japaneseGivenName;…
`POST https://zieapi.vercel.app/v1/ai:namsor/japanese-name-kanji-candidates-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Romanize japanese name, based on the name in Kanji.
`GET https://zieapi.vercel.app/v1/ai:namsor/japanese-name-latin-candidates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurnameKanji | string | yes |  |
| japaneseGivenNameKanji | string | yes |  |

### Romanize japanese names, based on the name in KANJI
`POST https://zieapi.vercel.app/v1/ai:namsor/japanese-name-latin-candidates-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Return a score for matching Japanese name in KANJI ex. 山本 早苗 with a romanized name ex. Yamamoto Sanae
`GET https://zieapi.vercel.app/v1/ai:namsor/japanese-name-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurnameLatin | string | yes |  |
| japaneseGivenNameLatin | string | yes |  |
| japaneseName | string | yes |  |

### Return a score for matching a list of Japanese names in KANJI ex. 山本 早苗 with romanized names ex. Yamamoto…
`POST https://zieapi.vercel.app/v1/ai:namsor/japanese-name-match-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [CREDITS 1 UNIT] Feedback loop to better perform matching Japanese name in KANJI ex. 山本 早苗 with a romanized…
`GET https://zieapi.vercel.app/v1/ai:namsor/japanese-name-match-feedback-loop` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseSurnameLatin | string | yes |  |
| japaneseGivenNameLatin | string | yes |  |
| japaneseName | string | yes |  |

### Activate/deactivate learning from a source.
`GET https://zieapi.vercel.app/v1/ai:namsor/learnable` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | yes | The API Key to set as learnable/non learnable. |
| learnable | boolean | yes |  |
| token | string | yes |  |

### Infer the likely type of a proper noun (personal name, brand name, place name etc.)
`GET https://zieapi.vercel.app/v1/ai:namsor/name-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| properNoun | string | yes |  |

### Infer the likely common type of up to 100 proper nouns (personal name, brand name, place name etc.)
`POST https://zieapi.vercel.app/v1/ai:namsor/name-type-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely type of a proper noun (personal name, brand name, place name etc.)
`GET https://zieapi.vercel.app/v1/ai:namsor/name-type-geo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| properNoun | string | yes |  |
| countryIso2 | string | yes |  |

### Infer the likely common type of up to 100 proper nouns (personal name, brand name, place name etc.)
`POST https://zieapi.vercel.app/v1/ai:namsor/name-type-geo-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely country of origin of a personal name. Assumes names as they are in…
`GET https://zieapi.vercel.app/v1/ai:namsor/origin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely country of origin of up to 100 names, detecting automatically the…
`POST https://zieapi.vercel.app/v1/ai:namsor/origin-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely first/last name structure of a name, ex. 王晓明 -> 王(surname) 晓明(given name)
`GET https://zieapi.vercel.app/v1/ai:namsor/parse-chinese-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseName | string | yes |  |

### Infer the likely first/last name structure of a name, ex. 王晓明 -> 王(surname) 晓明(given name).
`POST https://zieapi.vercel.app/v1/ai:namsor/parse-chinese-name-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely first/last name structure of a name, ex. 山本 早苗 or Yamamoto Sanae
`GET https://zieapi.vercel.app/v1/ai:namsor/parse-japanese-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| japaneseName | string | yes |  |

### Infer the likely first/last name structure of a name, ex. 山本 早苗 or Yamamoto Sanae
`POST https://zieapi.vercel.app/v1/ai:namsor/parse-japanese-name-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John.
`GET https://zieapi.vercel.app/v1/ai:namsor/parse-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nameFull | string | yes |  |

### Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John. For…
`GET https://zieapi.vercel.app/v1/ai:namsor/parse-name-geo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nameFull | string | yes |  |
| countryIso2 | string | yes |  |

### Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John.
`POST https://zieapi.vercel.app/v1/ai:namsor/parse-name-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John. Giving a…
`POST https://zieapi.vercel.app/v1/ai:namsor/parse-name-geo-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 11 UNITS PER NAME] Infer the likely country and phone prefix, given a personal name and formatted /…
`GET https://zieapi.vercel.app/v1/ai:namsor/phone-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |
| phoneNumber | string | yes |  |

### [USES 11 UNITS PER NAME] Infer the likely country and phone prefix, of up to 100 personal names, detecting…
`POST https://zieapi.vercel.app/v1/ai:namsor/phone-code-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 11 UNITS PER NAME] Infer the likely phone prefix, given a personal name and formatted / unformatted…
`GET https://zieapi.vercel.app/v1/ai:namsor/phone-code-geo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |
| phoneNumber | string | yes |  |
| countryIso2 | string | yes |  |

### [USES 11 UNITS PER NAME] Infer the likely country and phone prefix, of up to 100 personal names, with a…
`POST https://zieapi.vercel.app/v1/ai:namsor/phone-code-geo-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [CREDITS 1 UNIT] Feedback loop to better infer the likely phone prefix, given a personal name and formatted…
`GET https://zieapi.vercel.app/v1/ai:namsor/phone-code-geo-feedback-loop` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |
| phoneNumber | string | yes |  |
| phoneNumberE164 | string | yes |  |
| countryIso2 | string | yes |  |

### Romanize the Chinese name to Pinyin, ex. 王晓明 -> Wang (surname) Xiaoming (given name)
`GET https://zieapi.vercel.app/v1/ai:namsor/pinyin-chinese-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chineseName | string | yes |  |

### Romanize a list of Chinese name to Pinyin, ex. 王晓明 -> Wang (surname) Xiaoming (given name).
`POST https://zieapi.vercel.app/v1/ai:namsor/pinyin-chinese-name-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Print basic source statistics.
`GET https://zieapi.vercel.app/v1/ai:namsor/regions` (byok)

### [USES 10 UNITS PER NAME] Infer the likely religion of a personal full name. NB: only for INDIA (as of…
`GET https://zieapi.vercel.app/v1/ai:namsor/religion-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryIso2 | string | yes |  |
| subDivisionIso31662 | string | yes |  |
| personalNameFull | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely religion of up to 100 personal full names. NB: only for India as…
`POST https://zieapi.vercel.app/v1/ai:namsor/religion-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely religion of a personal Indian full name, provided the Indian state…
`GET https://zieapi.vercel.app/v1/ai:namsor/religion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subDivisionIso31662 | string | yes |  |
| personalNameFull | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely religion of up to 100 personal full Indian names, provided the…
`POST https://zieapi.vercel.app/v1/ai:namsor/religion-indian-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get the current software version
`GET https://zieapi.vercel.app/v1/ai:namsor/software-version` (byok)

### [USES 10 UNITS PER NAME] Infer the likely origin of a name at a country subclassification level (state or…
`GET https://zieapi.vercel.app/v1/ai:namsor/subclassification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryIso2 | string | yes |  |
| firstName | string | yes |  |
| lastName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely origin of a list of up to 100 names at a country subclassification…
`POST https://zieapi.vercel.app/v1/ai:namsor/subclassification-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely origin of a name at a country subclassification level (state or…
`GET https://zieapi.vercel.app/v1/ai:namsor/subclassification-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| countryIso2 | string | yes |  |
| fullName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely origin of a list of up to 100 names at a country subclassification…
`POST https://zieapi.vercel.app/v1/ai:namsor/subclassification-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely Indian state of Union territory according to ISO 3166-2:IN based…
`GET https://zieapi.vercel.app/v1/ai:namsor/subclassification-indian` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely Indian state of Union territory according to ISO 3166-2:IN based…
`POST https://zieapi.vercel.app/v1/ai:namsor/subclassification-indian-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer the likely Indian state of Union territory according to ISO 3166-2:IN based…
`GET https://zieapi.vercel.app/v1/ai:namsor/subclassification-indian-full` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fullName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer the likely Indian state of Union territory according to ISO 3166-2:IN based…
`POST https://zieapi.vercel.app/v1/ai:namsor/subclassification-indian-full-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Print the taxonomy classes valid for the given classifier.
`GET https://zieapi.vercel.app/v1/ai:namsor/taxonomy-classes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| classifierName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer a US resident's likely race/ethnicity according to US Census taxonomy W_NL…
`GET https://zieapi.vercel.app/v1/ai:namsor/us-race-ethnicity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |

### [USES 10 UNITS PER NAME] Infer up-to 100 US resident's likely race/ethnicity according to US Census…
`POST https://zieapi.vercel.app/v1/ai:namsor/us-race-ethnicity-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### [USES 10 UNITS PER NAME] Infer a US resident's likely race/ethnicity according to US Census taxonomy, using…
`GET https://zieapi.vercel.app/v1/ai:namsor/us-race-ethnicity-zip5` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| firstName | string | yes |  |
| lastName | string | yes |  |
| zip5Code | string | yes |  |

### [USES 10 UNITS PER NAME] Infer up-to 100 US resident's likely race/ethnicity according to US Census…
`POST https://zieapi.vercel.app/v1/ai:namsor/us-zip-race-ethnicity-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/ai:namsor/anonymize" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the NamSor API v2 API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ai:namsor/anonymize with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the NamSor API v2 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. NamSor API v2 itself also needs your own key from namsor.com.

### Can AI agents use the NamSor API v2 API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:namsor.

### What is the status of the NamSor API v2 API?
Needs your own provider key (bring your own key)