Calls & numbers

How much does it cost to call back?

API · Pro2026-10-28

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

Type the number that called you and we’ll tell you what kind of numbering it is and what calling back usually costs. It describes the number type, not the caller.

Requirements

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

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

How to use it

Number that called you
Check
Numbering type

Synthetic example

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

+44 1632 960123

Interpret the result

Indicative only: the final price depends on your operator and plan.

Premium rate: Far more expensive than a normal call; the service sets the per-minute price and it is not in your bundle.

Directory enquiries (118xx): High connection and per-minute charges; they may connect you elsewhere and keep charging.

Shared cost: You pay part of the call; many plans do not include it.

Freephone: Free from landlines and mobiles.

Satellite or global network: Among the highest per-minute rates there are.

High-rate international code: A code often seen in international missed-call (wangiri) campaigns. Charged as international and can be expensive.

International: Charged as an international call by your operator.

National landline or mobile: Like a national call; usually in your plan.

Not recognised: We can’t classify it. Check the price with your operator before calling.

Limitations

Indicative only: the final price depends on your operator and plan.

Indicative information from published numbering plans. It describes the type of number, never the person or company behind it.

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

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.

Cost tier of calling the number back (premium, shared cost, free, international, satellite, wangiri, …) and the matching registry range.

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/callback-cost
POST https://api.nocall.io/v2/tools  {"tool":"callback-cost","phone":"806123456","country":"ES"}

Parameters

Name	Type	Required	Description
phone	string (1–40)	Yes	Phone number in E.164 (+34…) or national format.
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/callback-cost' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"806123456","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/callback-cost',
    method='POST',
    data=json.dumps({'phone': '806123456', '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/callback-cost', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ phone: '806123456', 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": "callback-cost",
    "result": {
      "tier": "premium",
      "scope": "national",
      "callingCode": null,
      "registry": {
        "prefix": "806",
        "serviceClass": "premium",
        "costClass": "premium",
        "geography": null,
        "indexable": true
      }
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Result fields (data.result)

Field	Type	Description
tier	string (enum, 9)	Cost tier of calling the number back.
scope	"national" \| "international"	Whether the number is national or international.
callingCode	string \| null	International calling code, or null for a national number.
registry	object \| null	Matching numbering range from the registry, or null.

API reference