Directories
Insights
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 toolOn this page
Purpose
Open the directory for your edition, choose a category and open an entry to read its data. Counts describe data available in NoCall, not every call in the country. Missing data does not prove a number is safe.
Requirements
Anyone can read these guides, no account needed. Some tools require Pro, as indicated in each guide.
How to use it
Select the country edition, open the category or row you need and review the available details.
Insights
Category
Synthetic example
Invented example, not a real lookup. Do not call or open its links.
+44 1632 960123Interpret the result
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
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.
Troubleshooting
The security check or API connection did not respond in time. Try again in a few seconds.
Read the available fields alongside their limitations. An empty result does not prove safety or identify a person.
Use with the API
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.
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.
Detailed country aggregates: totals, 24 h activity, categories, number types and operators (ES only), prefixes, search trends, regions, impersonated companies and AI breakdowns. No phone numbers. A country that is not ready yet is 503 tool_warming.
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.
POST https://api.nocall.io/v2/trends
POST https://api.nocall.io/v2/tools {"tool":"trends","country":"ES"}Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| country | string (enum, 56) | No (default: "ES") | Two-letter country code, for example ES or US, used for national input and for the country's data. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/trends' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"country":"ES"}'import json
import os
import urllib.request
import uuid
api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
raise SystemExit('Set NOCALL_API_KEY')
request = urllib.request.Request(
'https://api.nocall.io/v2/trends',
method='POST',
data=json.dumps({'country': 'ES'}).encode(),
headers={
'Authorization': 'Bearer ' + api_key,
'Content-Type': 'application/json',
'Idempotency-Key': str(uuid.uuid4()),
},
)
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])import { randomUUID } from 'node:crypto';
const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');
const response = await fetch('https://api.nocall.io/v2/trends', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ country: 'ES' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);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.
{
"data": {
"tool": "trends",
"result": {
"totals": {
"blockedNumbers": 0,
"reports": 0,
"comments": 0,
"aiAnalyzed": 0
},
"activity24h": {
"blockedNumbers": 0,
"reports": 0,
"comments": 0
},
"verification": {
"verifiedBlocked": 0,
"unverifiedBlocked": 0
},
"freshness": {
"blockedNumbers": null,
"reports": null,
"comments": null,
"aiAnalyzed": null
},
"categoryDistribution": [],
"phoneTypes": [],
"growthTimeline": [],
"topPrefixes": [],
"searchTrends": [],
"communityDistribution": [],
"impersonationRanking": [],
"aiBreakdown": {
"dangerLevels": [],
"sectors": [],
"tactics": [],
"purposes": []
}
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}Result fields (data.result)
| Field | Type | Description |
|---|---|---|
| totals | object | All-time totals: blocked numbers, reports, comments and AI analyses. |
| activity24h | object | Blocked numbers, reports and comments in the last 24 hours. |
| verification | object | Verified and unverified blocked numbers. |
| freshness | object | When each dataset was last updated, or null. |
| categoryDistribution | array<object> | Reports per category. |
| phoneTypes | array<object> | Reports per number type. Only for ES; an empty list for other countries. |
| topOperators | array<object> | Operators with the most reports. Only for ES while the operator breakdown is enabled; otherwise the field is omitted. |
| growthTimeline | array<object> | Reports per week. |
| topPrefixes | array<object> | Most reported prefixes. |
| searchTrends | array<object> | Searches per day. |
| communityDistribution | array<object> | Reports per region. |
| impersonationRanking | array<object> | Most impersonated companies. |
| aiBreakdown | object | Breakdown of the AI analyses: danger levels, sectors, tactics and purposes. |
