# Number Insight API API

> Number Insight API API on Apizie: 4 endpoints (Advanced Number Insight (async), Advanced Number Insight (sync), Basic Number Insight, Standard Number Insight) 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://apizie.tech/v1/open-data:nexmo-number-insight/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:nexmo-number-insight`
- Category: Open Data
- Status: byok
- Source: https://developer.nexmo.com/
- Page: https://apizie.tech/api/open-data/nexmo-number-insight
- OpenAPI: https://apizie.tech/api/open-data/nexmo-number-insight/openapi.json

The Number Insight API delivers real-time intelligence about the validity, reachability and roaming status of a phone number and tells you how to format the number correctly in your application. There are three levels…

## Endpoints

### Advanced Number Insight (async)
`GET https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | The format of the response |
| callback | string | yes | The callback URL |
| number | string | yes | A single phone number that you need insight about in national or international format. |
| country | string | no | If a number does not have a country code or is uncertain, set the two-character country code. This code must be in ISO 3166-1 alpha-2… |
| cnam | boolean | no | Indicates if the name of the person who owns the phone number should be looked up and returned in the response. Set to true to receive… |
| ip | string | no | This parameter is deprecated as we are no longer able to retrieve reliable IP data globally from carriers. |

### Advanced Number Insight (sync)
`GET https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-advanced` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | The format of the response |
| real_time_data | boolean | no | A boolean to choose whether to get real time data back in the response. |
| number | string | yes | A single phone number that you need insight about in national or international format. |
| country | string | no | If a number does not have a country code or is uncertain, set the two-character country code. This code must be in ISO 3166-1 alpha-2… |
| cnam | boolean | no | Indicates if the name of the person who owns the phone number should be looked up and returned in the response. Set to true to receive… |
| ip | string | no | This parameter is deprecated as we are no longer able to retrieve reliable IP data globally from carriers. |

### Basic Number Insight
`GET https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | The format of the response |
| number | string | yes | A single phone number that you need insight about in national or international format. |
| country | string | no | If a number does not have a country code or is uncertain, set the two-character country code. This code must be in ISO 3166-1 alpha-2… |

### Standard Number Insight
`GET https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-standard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | The format of the response |
| number | string | yes | A single phone number that you need insight about in national or international format. |
| country | string | no | If a number does not have a country code or is uncertain, set the two-character country code. This code must be in ISO 3166-1 alpha-2… |
| cnam | boolean | no | Indicates if the name of the person who owns the phone number should be looked up and returned in the response. Set to true to receive… |

## Example
```
curl "https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-async" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Number Insight API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/open-data:nexmo-number-insight/get-number-insight-async with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Number Insight API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:nexmo-number-insight.

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