In questa pagina
NoCall

Chiamate e numeri

Verifica e formatta un numero di telefono

API · Pro

Copertura: Funziona per tutti i paesi, con i dati dei piani di numerazione della libreria open source libphonenumber. I numeri scritti senza + vengono letti come numeri del paese di questa edizione. NoCall aggiunge la nuova numerazione 400 della Spagna e i suoi numeri di informazione elenco 118xx, che la libreria non descrive ancora.

Apri lo strumento
In questa pagina

A cosa serve

Controlla se un numero di telefono è valido, se è un cellulare, un fisso, un numero verde o a sovrapprezzo, e visualizzalo in formato E.164, nazionale e internazionale.

Requisiti

Chiunque può leggere queste guide, senza account. Alcuni strumenti richiedono Pro, come indicato in ogni guida.

Incolla qualsiasi numero di telefono per controllare se è valido, che tipo di numero è e come si scrive in formato E.164, nazionale e internazionale.

Come usarlo

  1. Apri lo strumento

  2. Incolla qualsiasi numero di telefono per controllare se è valido, che tipo di numero è e come si scrive in formato E.164, nazionale e internazionale.

  3. Controlla

  4. Leggi i campi disponibili insieme ai loro limiti. Un risultato vuoto non dimostra sicurezza e non identifica una persona.

Esempio inventato

Nota

Esempio inventato, non una ricerca reale. Non chiamare e non aprire i suoi link.

Esempio inventato
+44 1632 960123

Interpretare il risultato

Leggi i campi disponibili insieme ai loro limiti. Un risultato vuoto non dimostra sicurezza e non identifica una persona.

È lo standard internazionale per scrivere un numero: un segno più, il prefisso del paese e il numero nazionale, senza spazi né zero iniziale. App e sistemi telefonici lo usano per memorizzare i numeri.

No. Valido significa che appartiene a una numerazione assegnata nel piano di numerazione. Se quel numero preciso sia attivo oggi lo sa solo l’operatore.

Il tipo dipende dalla numerazione, non dalla linea, e resta lo stesso quando il numero passa a un altro operatore. I numeri di telefonia via internet possono sembrare numeri fissi.

Limiti

Attenzione

Funziona per tutti i paesi, con i dati dei piani di numerazione della libreria open source libphonenumber. I numeri scritti senza + vengono letti come numeri del paese di questa edizione. NoCall aggiunge la nuova numerazione 400 della Spagna e i suoi numeri di informazione elenco 118xx, che la libreria non descrive ancora.

Informazioni indicative tratte dai piani di numerazione pubblicati. Descrivono il tipo di numero, mai la persona o l’azienda che c’è dietro.

Risoluzione dei problemi

Se il dato non è valido, controlla formato e paese. Riprova dopo errori di connessione; rispetta l’attesa quando raggiungi un limite.

Inserisci un numero di telefono o un prefisso valido.

Non siamo riusciti a controllarlo ora. Riprova tra un momento.

Usare con l’API

Attenzione

Richiede una API key e dei crediti. Ogni chiamata completata costa 1 credito, anche quando non ci sono dati. Un account Pro attivo include 20 crediti per mese solare UTC, condivisi da tutte le rotte API e consumati per primi; i crediti mensili non usati non passano al mese successivo. I crediti acquistati nella pagina del tuo account funzionano senza Pro e non scadono mai.

Nota

Gli errori non vengono mai addebitati: 401 invalid_api_key (chiave mancante o non valida), 403 pro_required (nessun credito Pro e nessun credito acquistato), 422 input non valido, 429 quota_exceeded (crediti esauriti), rate_limit_exceeded o ai_busy (l’IA di sms-check è al limite della capacità), 503 tool_warming (i dati sono ancora in preparazione) o tool o provider non disponibile. Dopo un 429 o un 503, riprova quando sono trascorsi i secondi indicati nell’intestazione Retry-After.

Validità, possibilità, tipo, paese, prefisso internazionale ed E.164 secondo il piano di numerazione. Qualsiasi input simile a un numero di telefono è un risultato riuscito: viene restituito valid=false, mai un errore.

Invia il corpo JSON alla rotta specifica del tool, oppure a POST /v2/tools aggiungendo il campo tool. Entrambe le rotte restituiscono lo stesso risultato.

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

Parametri

NomeTipoObbligatorioDescrizione
phonestring (1–40)SìNumero di telefono in formato E.164 (+34…) o nazionale.
countrystring (enum, 56)No (predefinito: "ES")Codice paese di due lettere, ad esempio ES o US, usato per l’input nazionale e per i dati del paese.
bash
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/number-validator' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+12025550123","country":"US"}'

Esempio di risposta (200)

Questo è l’esempio documentato nel riferimento API. Le ricerche usano un numero fittizio, mentre aggregati e risposte dell’IA mostrano la struttura del risultato, non dati reali.

JSON
{
  "data": {
    "tool": "number-validator",
    "result": {
      "valid": true,
      "possible": true,
      "country": "US",
      "callingCode": "1",
      "type": "fixed_line_or_mobile",
      "e164": "+12025550123"
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Campi del risultato (data.result)

CampoTipoDescrizione
validbooleanSe il numero è valido secondo il piano di numerazione. false è comunque un risultato completato.
possiblebooleanSe il numero ha una lunghezza possibile per il paese.
countrystring | nullPaese del numero (codice ISO), oppure null se non può essere determinato.
callingCodestring | nullPrefisso internazionale del paese del numero, oppure null se sconosciuto.
typestring (enum, 14)Tipo di numero secondo il piano di numerazione, ad esempio mobile, fixed_line, toll_free o premium_rate; unknown se non può essere classificato.
e164string | nullIl numero in formato E.164, oppure null se non può essere formattato.

Domande frequenti

Che cos’è il formato E.164?

È lo standard internazionale per scrivere un numero: un segno più, il prefisso del paese e il numero nazionale, senza spazi né zero iniziale. App e sistemi telefonici lo usano per memorizzare i numeri.

Un numero valido è per forza attivo?

No. Valido significa che appartiene a una numerazione assegnata nel piano di numerazione. Se quel numero preciso sia attivo oggi lo sa solo l’operatore.

Un numero può passare da cellulare a fisso?

Il tipo dipende dalla numerazione, non dalla linea, e resta lo stesso quando il numero passa a un altro operatore. I numeri di telefonia via internet possono sembrare numeri fissi.