On this page

Calls & numbers

Research a number with AI

API · Pro

Coverage: Areas come from the official numbering plan of each edition’s country. Spain lists a province for every landline range; many other countries list their area codes and cities. Mobile numbers have no area in any country, and a few countries do not publish a plan we can read yet: there we only show the type of line.

Open tool
On this page

Purpose

We search the web in real time for what is known about a number and summarize it with AI, with its sources. A NoCall Pro feature.

Requirements

Warning

Tool plan: Pro

Anyone can read these guides, no account needed. Some tools require Pro, as indicated in each guide.

Activate NoCall Pro to research any number on the web with AI and see its sources.

How to use it

  1. Open tool

  2. Enter the full number with its international code. For a national number, first check the edition country or country selector.

  3. Check

  4. Read the available fields alongside their limitations. An empty result does not prove safety or identify a person.

Synthetic example

Note

Invented example, not a real lookup. Do not call or open its links.

Synthetic example
+44 1632 960123

Interpret the result

Read the available fields alongside their limitations. An empty result does not prove safety or identify a person.

Web research

Information based on community reports and automated analysis. It may contain errors or be out of date, and is not legal advice or a verified accusation against the number's owner.

Limitations

Warning

Information based on community reports and automated analysis. It may contain errors or be out of date, and is not legal advice or a verified accusation against the number's owner.

Only reviewed or public technical facts are shown. Private identities and protection signals stay hidden.

Troubleshooting

If the input is invalid, check its format and country. Retry connection errors; respect the waiting period when a limit is reached.

Invalid phone number

The security check or API connection did not respond in time. Try again in a few seconds.

Use with the API

Warning

Needs an API key and credits. Each completed call costs 1 credit, even when there is no data. An active Pro account includes 20 credits per UTC calendar month, shared by every API route and spent first; unused monthly credits do not roll over. Credits bought on your account page work without Pro and never expire.

Note

Errors are never charged: 401 invalid_api_key (missing or invalid key), 403 pro_required (no Pro credits and no purchased credits), 422 invalid input, 429 quota_exceeded (no credits left), rate_limit_exceeded or ai_busy (the AI of sms-check is at capacity), 503 tool_warming (the data is still being prepared) or tool or provider unavailable. After a 429 or 503, retry once the seconds in the Retry-After header have passed.

Note

The answer comes from AI web research and is cached for 30 days per number and language. A cached answer also costs 1 credit.

AI web research summary for the number with its sources, cached 30 days per number and language.

Send the JSON body to the tool's own route, or to POST /v2/tools with the tool field added. Both routes return the same result.

Endpoint
POST https://api.nocall.io/v2/number-research
POST https://api.nocall.io/v2/tools  {"tool":"number-research","phone":"+12025550123","country":"US","language":"en"}

Parameters

NameTypeRequiredDescription
phonestring (1–40)YesPhone number in E.164 (+34…) or national format.
countrystring (enum, 56)No (default: "ES")Two-letter country code, for example ES or US, used for national input and for the country's data.
languagestring (enum, 33)No (default: "en")Language of the research answer.
bash
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/number-research' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+12025550123","country":"US","language":"en"}'

Example response (200)

This is the documented example from the API reference. Lookups use a fictional number, and aggregates and AI answers show the shape of the result, not live data.

JSON
{
  "data": {
    "tool": "number-research",
    "result": {
      "answer": "No public business or report is associated with this number in the sources reviewed.",
      "sources": [],
      "countryCode": "US",
      "language": "en",
      "cached": false
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Result fields (data.result)

FieldTypeDescription
answerstringSummary of the AI web research.
sourcesarray<string>URLs of the sources used.
countryCodestring | nullCountry code of the number, or null.
languagestringLanguage of the answer.
cachedbooleanWhether the answer came from the 30-day cache. It still costs 1 credit.