---
canonical_url: "https://docs.composio.dev/toolkits/namsor"
markdown_url: "https://docs.composio.dev/toolkits/namsor.md"
product: "platform"
version: null
last_updated: null
---

# NamSor

NamSor classifies, parses, and enriches personal names to infer attributes such as gender, country of origin, ethnicity, and cultural context.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `NAMSOR`
- **Version:** 00000000_00

## Tools

### Classify Name Diaspora

**Slug:** `NAMSOR_CLASSIFY_DIASPORA`

Infer likely diaspora or ethnicity labels for one or more names within a known country of residence. Accepts 1-100 names and uses 20 NamSor credits per name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Names and residence contexts to classify (1-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Classify Name Gender

**Slug:** `NAMSOR_CLASSIFY_GENDER`

Infer likely gender for one or more first-and-last names. Accepts 1-100 names and costs about 1 NamSor credit per name; results are probabilistic, not verified identity attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Names to classify (1-100); each item contains first_name, last_name, and an optional caller-defined id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Classify Name Origin

**Slug:** `NAMSOR_CLASSIFY_ORIGIN`

Infer likely countries and region of origin for one or more first-and-last names. Accepts 1-100 names and uses 10 NamSor credits per name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Names to classify (1-100); each item contains first_name, last_name, and an optional caller-defined id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Classify Proper-Noun Type

**Slug:** `NAMSOR_CLASSIFY_PROPER_NOUN_TYPE`

Classify one or more proper nouns as likely personal names, brand names, place names, or other NamSor types. Accepts 1-100 values and costs about 1 credit each.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Proper nouns to classify (1-100); each item contains a name and an optional caller-defined id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Classify Residence Country

**Slug:** `NAMSOR_CLASSIFY_RESIDENCE_COUNTRY`

Infer likely countries and region of residence for one or more full personal names. Accepts 1-100 names and uses 10 NamSor credits per name; this differs from country of origin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Full names to classify (1-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Usage

**Slug:** `NAMSOR_GET_ACCOUNT_USAGE`

Return the connected NamSor account's plan, quota, current billing-period usage, limits, and overage summary without exposing its API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Parse Personal Names

**Slug:** `NAMSOR_PARSE_NAMES`

Parse one or more full personal names into likely first-name and last-name components. Accepts 1-100 names and costs about 1 NamSor credit per name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `names` | array | Yes | Full names to parse (1-100); each item contains full_name and an optional caller-defined id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |