On this page

Directories

Insights

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

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

  1. Select the country edition, open the category or row you need and review the available details.

  2. Insights

  3. Category

Synthetic example

Note

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

Synthetic example
+44 1632 960123

Interpret 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

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.

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

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.

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.

Endpoint
POST https://api.nocall.io/v2/trends
POST https://api.nocall.io/v2/tools  {"tool":"trends","country":"ES"}

Parameters

NameTypeRequiredDescription
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.
bash
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"}'

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": "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)

FieldTypeDescription
totalsobjectAll-time totals: blocked numbers, reports, comments and AI analyses.
activity24hobjectBlocked numbers, reports and comments in the last 24 hours.
verificationobjectVerified and unverified blocked numbers.
freshnessobjectWhen each dataset was last updated, or null.
categoryDistributionarray<object>Reports per category.
phoneTypesarray<object>Reports per number type. Only for ES; an empty list for other countries.
topOperatorsarray<object>Operators with the most reports. Only for ES while the operator breakdown is enabled; otherwise the field is omitted.
growthTimelinearray<object>Reports per week.
topPrefixesarray<object>Most reported prefixes.
searchTrendsarray<object>Searches per day.
communityDistributionarray<object>Reports per region.
impersonationRankingarray<object>Most impersonated companies.
aiBreakdownobjectBreakdown of the AI analyses: danger levels, sectors, tactics and purposes.