Hovory a čísla

Vyhledat operátora

API · ProBeta2026-10-28

Pokrytí: Oblasti pocházejí z oficiálního číslovacího plánu země každé edice. Španělsko uvádí provincii pro každý rozsah pevných linek; mnoho dalších zemí uvádí své předvolby a města. Mobilní čísla nemají oblast v žádné zemi a několik zemí zatím nezveřejňuje plán, který bychom mohli načíst: tam ukazujeme jen druh linky.

Otevřít nástroj

Na této stránce

Účel

Zadejte číslo a zobrazte schválené údaje omezené ochranou soukromí.

Informace o operátorovi · Typ: · Provincie:.

Požadavky

Tyto návody může číst kdokoli, i bez účtu. Některé nástroje vyžadují Pro, jak uvádí příslušný návod.

Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.

Jak používat

Otevřít nástroj
Zadejte celé číslo s mezinárodní předvolbou. U národního čísla nejprve ověřte zemi edice nebo výběru.
Ověřit
Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.

Smyšlený příklad

Smyšlený příklad, nikoli skutečný dotaz. Nevolejte ani neotevírejte jeho odkazy.

+44 1632 960123

Jak chápat výsledek

Čtěte dostupná pole spolu s omezeními. Prázdný výsledek nedokazuje bezpečnost ani neurčuje totožnost osoby.

Informace o operátorovi · Typ: · Provincie:.

Toto číslo není v naší databázi. Buďte první, kdo ho nahlásí.

Zobrazujeme jen ověřená nebo veřejná technická fakta. Soukromé identity a ochranné signály zůstávají skryté.

Omezení

Zobrazujeme jen ověřená nebo veřejná technická fakta. Soukromé identity a ochranné signály zůstávají skryté.

Orientační informace ze zveřejněných číslovacích plánů. Popisuje druh čísla, nikdy osobu ani firmu, která za ním stojí.

Informace založené na hlášeních komunity a automatické analýze. Mohou obsahovat chyby nebo být zastaralé a nejsou právní radou ani ověřeným obviněním vlastníka čísla.

Řešení potíží

U neplatného vstupu ověřte formát a zemi. Při chybě spojení zkuste znovu; při dosažení limitu dodržte čekací dobu.

Neplatné telefonní číslo

Bezpečnostní kontrola nebo připojení k API neodpovědělo včas. Zkuste to znovu za pár sekund.

Použili jste všechna dnes povolená vyhledávání telefonních čísel. Zkuste to prosím znovu zítra.

Použít přes API

Vyžaduje API klíč a kredity. Každé dokončené volání stojí 1 kredit, i když nejsou k dispozici žádná data. Aktivní účet Pro zahrnuje 20 kreditů na kalendářní měsíc UTC, sdílených všemi cestami API a čerpaných jako první; nevyčerpané měsíční kredity se nepřevádějí. Kredity zakoupené na stránce vašeho účtu fungují i bez Pro a nikdy nevyprší.

Chyby se nikdy neúčtují: 401 invalid_api_key (chybějící nebo neplatný klíč), 403 pro_required (žádné kredity Pro ani zakoupené kredity), 422 neplatný vstup, 429 quota_exceeded (žádné zbývající kredity), rate_limit_exceeded nebo ai_busy (AI pro sms-check je plně vytížená), 503 tool_warming (data se teprve připravují) nebo tool či poskytovatel nedostupný. Po odpovědi 429 nebo 503 to zkuste znovu, až uplyne počet sekund z hlavičky Retry-After.

Přidělený operátor a číslovací údaje ze španělského registru CNMC nebo z údajů regulátorů importovaných pro další země (operátor, typ čísla, předvolba, region, cenová kategorie). found je true jen tehdy, když je uveden operátor.

Pošli tělo JSON na vlastní cestu toolu, nebo na POST /v2/tools s přidaným polem tool. Obě cesty vrátí stejný výsledek.

POST https://api.nocall.io/v2/carrier-lookup
POST https://api.nocall.io/v2/tools  {"tool":"carrier-lookup","phone":"+12025550123","country":"US"}

Parametry

Název	Typ	Povinný	Popis
phone	string (1–40)	Ano	Telefonní číslo ve formátu E.164 (+34…) nebo v národním formátu.
country	string (enum, 56)	Ne (výchozí: "ES")	Dvoupísmenný kód země, například ES nebo US, používaný pro národní vstup a pro data dané země.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/carrier-lookup' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+12025550123","country":"US"}'

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/carrier-lookup',
    method='POST',
    data=json.dumps({'phone': '+12025550123', 'country': 'US'}).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/carrier-lookup', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ phone: '+12025550123', country: 'US' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

Ukázková odpověď (200)

Jde o zdokumentovaný příklad z reference API. Vyhledávání používají smyšlené číslo a agregace i odpovědi AI ukazují tvar výsledku, ne živá data.

{
  "data": {
    "tool": "carrier-lookup",
    "result": {
      "phoneNumber": "+12025550123",
      "found": false,
      "updatedAt": null,
      "carrier": null
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Pole výsledku (data.result)

Pole	Typ	Popis
phoneNumber	string	Číslo ve formátu E.164.
found	boolean	Zda má NoCall k tomuto číslu skutečná data: uvedeného operátora, záznam v blokovacím seznamu nebo adresáři, schválená hlášení nebo ověřenou firmu. Samotné údaje o předvolbě se nepočítají. false je stále dokončený výsledek.
updatedAt	string \| null	Kdy byla data naposledy aktualizována (ISO 8601), nebo null.
carrier	object \| null	Údaje o operátorovi ze španělského registru CNMC nebo od regulátora dané země: operátor, typ čísla, předvolba, region a cenová kategorie. null, pokud nejsou známy.

Dokumentace API