In questa pagina
NoCall

Chiamate e numeri

Formati dei numeri

API · Pro

Copertura: Le zone provengono dal piano di numerazione ufficiale del paese di ogni edizione. La Spagna indica una provincia per ogni numerazione fissa; molti altri paesi pubblicano i propri prefissi e città. I cellulari non hanno una zona in nessun paese, e alcuni paesi non pubblicano ancora un piano che possiamo leggere: lì mostriamo solo il tipo di linea.

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.

Inserisci il numero completo con prefisso internazionale. Per un numero nazionale, verifica prima il paese dell’edizione o del selettore.

Come usarlo

  1. Formati dei numeri

  2. Inserisci il numero completo con prefisso internazionale. Per un numero nazionale, verifica prima il paese dell’edizione o del selettore.

  3. Controlla

  4. E.164 · Senza prefisso internazionale · Formato internazionale

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

È 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.

Limiti

Attenzione

Solo formati e prefissi supportati. Non confermano posizione, intestatario o attività del numero. Alcuni prefissi sono condivisi.

Risoluzione dei problemi

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

Numero di telefono non valido

Il controllo di sicurezza o la connessione all'API non ha risposto in tempo. Riprova tra qualche secondo.

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.

Formati E.164, nazionale e internazionale, prefisso internazionale, paese e validità secondo il piano di numerazione. Un numero possibile ma non assegnato restituisce valid=false.

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

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/phone-formats' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"phone":"+34912345678","country":"ES"}'

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": "phone-formats",
    "result": {
      "e164": "+34912345678",
      "national": "912 34 56 78",
      "international": "+34 912 34 56 78",
      "callingCode": "34",
      "country": "ES",
      "valid": true
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Campi del risultato (data.result)

CampoTipoDescrizione
e164stringIl numero in formato E.164, oppure null se non può essere formattato.
nationalstringIl numero nel formato nazionale del suo paese.
internationalstringIl numero in formato internazionale.
callingCodestringPrefisso internazionale del paese del numero, oppure null se sconosciuto.
countrystring | nullPaese del numero (codice ISO), oppure null se non può essere determinato.
validbooleanSe il numero è valido secondo il piano di numerazione. false è comunque un risultato completato.