Valider et formater un numéro de téléphone

Objectif

Vérifiez si un numéro de téléphone est valide, s’il s’agit d’un mobile, d’un fixe, d’un numéro gratuit ou surtaxé, et affichez-le aux formats E.164, national et international.

Prérequis

Tout le monde peut lire ces guides, sans compte. Certains outils nécessitent Pro, comme indiqué dans chaque guide.

Collez n’importe quel numéro de téléphone pour vérifier s’il est valide, de quel type de numéro il s’agit et comment l’écrire aux formats E.164, national et international.

Mode d’emploi

1. 1

   Ouvrir l’outil

2. 2

   Collez n’importe quel numéro de téléphone pour vérifier s’il est valide, de quel type de numéro il s’agit et comment l’écrire aux formats E.164, national et international.

3. 3

   Vérifier

4. 4

   Lisez les champs disponibles avec leurs limites. Un résultat vide ne prouve pas la sécurité et n’identifie personne.

Exemple fictif

+44 1632 960123

Interpréter le résultat

Lisez les champs disponibles avec leurs limites. Un résultat vide ne prouve pas la sécurité et n’identifie personne.

C’est la norme internationale pour écrire un numéro : un signe plus, l’indicatif du pays et le numéro national, sans espaces ni zéro initial. Les applications et les systèmes téléphoniques l’utilisent pour enregistrer les numéros.

Non. Valide signifie qu’il appartient à une tranche attribuée dans le plan de numérotation. Seul l’opérateur sait si ce numéro précis est actif aujourd’hui.

Le type dépend de la tranche, pas de la ligne, et il ne change pas quand le numéro passe chez un autre opérateur. Les numéros de téléphonie par internet peuvent ressembler à des fixes.

Limites

Informations indicatives issues des plans de numérotation publiés. Elles décrivent le type de numéro, jamais la personne ou l’entreprise qui se trouve derrière.

Résoudre un problème

Si la saisie est invalide, vérifiez le format et le pays. Réessayez après une erreur de connexion ; respectez le délai si une limite est atteinte.

Saisissez un numéro de téléphone ou un indicatif valide.

Impossible de vérifier pour le moment. Réessayez dans un instant.

Utiliser avec l’API

Validité, possibilité, type, pays, indicatif et E.164 selon le plan de numérotation. Toute entrée ressemblant à un numéro est un résultat réussi : valid=false est renvoyé, jamais une erreur.

Envoyez le corps JSON à la route propre au tool, ou à POST /v2/tools en ajoutant le champ tool. Les deux routes renvoient le même résultat.

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

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"}'

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/number-validator',
    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/number-validator', {
  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);

{
  "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
    }
  }
}

• Référence API ↗

Questions fréquentes

Guides associés

• Combien coûte un rappel ?
• Qui m’appelle ?