Appels et numéros
D’où vient cet indicatif ?
Couverture: Les zones proviennent du plan de numérotation officiel du pays de chaque édition. L’Espagne indique une province pour chaque tranche de fixes ; beaucoup d’autres pays publient leurs indicatifs et leurs villes. Les numéros mobiles n’ont de zone dans aucun pays, et quelques pays ne publient pas encore de plan que nous puissions lire : nous n’y affichons que le type de ligne.
Ouvrir l’outilSur cette page
Objectif
Saisissez un numéro ou un indicatif pour voir à quelle province, ville ou zone il appartient, de quel type de ligne il s’agit et combien coûte un appel.
Prérequis
Tout le monde peut lire ces guides, sans compte. Certains outils nécessitent Pro, comme indiqué dans chaque guide.
Saisissez un numéro de téléphone ou seulement ses premiers chiffres. Nous le cherchons dans le plan de numérotation officiel et vous indiquons à quelle zone il appartient, de quel type de ligne il s’agit et ce que coûte généralement un appel.
Mode d’emploi
Ouvrir l’outil
Saisissez un numéro de téléphone ou seulement ses premiers chiffres. Nous le cherchons dans le plan de numérotation officiel et vous indiquons à quelle zone il appartient, de quel type de ligne il s’agit et ce que coûte généralement un appel.
Vérifier
Lisez les champs disponibles avec leurs limites. Un résultat vide ne prouve pas la sécurité et n’identifie personne.
Exemple fictif
Exemple inventé, pas une recherche réelle. N’appelez pas et n’ouvrez pas ses liens.
+44 1632 960123Interpré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.
Non. Il indique la zone à laquelle le numéro a été attribué. Une ligne fixe peut être déplacée ailleurs et un numéro de téléphonie par internet peut être utilisé n’importe où : c’est un indice, pas une localisation.
Les tranches mobiles sont nationales : les premiers chiffres indiquent seulement qu’il s’agit d’une ligne mobile, pas où elle a été ouverte ni quel opérateur la gère aujourd’hui.
Oui. Elles proviennent du plan de numérotation publié par le régulateur du pays ou par l’ITU, et sont mises à jour quand le plan change.
Limites
Les zones proviennent du plan de numérotation officiel du pays de chaque édition. L’Espagne indique une province pour chaque tranche de fixes ; beaucoup d’autres pays publient leurs indicatifs et leurs villes. Les numéros mobiles n’ont de zone dans aucun pays, et quelques pays ne publient pas encore de plan que nous puissions lire : nous n’y affichons que le type de ligne.
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
Nécessite une API key et des crédits. Chaque appel abouti coûte 1 crédit, même sans données. Un compte Pro actif inclut 20 crédits par mois calendaire UTC, partagés entre toutes les routes de l’API et consommés en premier ; les crédits mensuels non utilisés ne sont pas reportés. Les crédits achetés sur la page de votre compte fonctionnent sans Pro et n’expirent jamais.
Les erreurs ne sont jamais facturées : 401 invalid_api_key (clé absente ou invalide), 403 pro_required (ni crédits Pro ni crédits achetés), 422 entrée invalide, 429 quota_exceeded (plus de crédits), rate_limit_exceeded ou ai_busy (l’IA de sms-check est à pleine capacité), 503 tool_warming (les données sont encore en préparation) ou tool ou fournisseur indisponible. Après un 429 ou un 503, réessayez une fois écoulées les secondes indiquées dans l’en-tête Retry-After.
À quoi correspond un préfixe ou un numéro : une plage de numérotation exacte, jusqu’à 8 suggestions, un indicatif étranger, ou aucune correspondance.
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/prefix-origin
POST https://api.nocall.io/v2/tools {"tool":"prefix-origin","phone":"910","country":"ES"}Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| phone | string (1–40) | Oui | Numéro de téléphone ou préfixe, au format E.164 ou national. |
| country | string (enum, 56) | Non (par défaut: "ES") | Code pays à deux lettres, par exemple ES ou US, utilisé pour les saisies au format national et pour les données du pays. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/prefix-origin' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"910","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/prefix-origin',
method='POST',
data=json.dumps({'phone': '910', '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/prefix-origin', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '910', 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);Exemple de réponse (200)
Il s’agit de l’exemple documenté dans la référence de l’API. Les recherches utilisent un numéro fictif ; les agrégats et les réponses de l’IA montrent la structure du résultat, pas des données réelles.
{
"data": {
"tool": "prefix-origin",
"result": {
"kind": "match",
"national": "910",
"row": {
"prefix": "910",
"serviceClass": "geographic",
"costClass": "standard",
"geography": "Madrid",
"indexable": true
},
"complete": false,
"planLoaded": true,
"numberType": null,
"foreignCode": null
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}Champs du résultat (data.result)
| Champ | Type | Description |
|---|---|---|
| kind | "foreign" | "match" | "suggestions" | "no_match" | Type d’expéditeur. |
| planLoaded | boolean | Indique si le plan de numérotation du pays est disponible. |
| numberType | string (enum, 14) | null | Type de numéro selon le plan de numérotation, ou null. |
| foreignCode | string | null | Indicatif étranger détecté dans la saisie, ou null. |
| national | string | Chiffres nationaux de l’entrée qui ont été recherchés. |
| row | object | La tranche de numérotation correspondante : préfixe, classe de service, classe de coût et zone géographique. |
| complete | boolean | Indique si l’entrée est déjà un numéro complet et valide du pays, et pas seulement un préfixe. |
| rows | array<object> | Jusqu’à 8 tranches de numérotation auxquelles l’entrée peut appartenir. |
| factsType | "mobile" | "landline" | "toll_free" | "premium" | null | Si aucune tranche ne correspond, le type suggéré par les règles de numérotation du pays (mobile, landline, toll_free ou premium), ou null. |
Questions fréquentes
Un indicatif me dit-il où se trouve l’appelant ?
Non. Il indique la zone à laquelle le numéro a été attribué. Une ligne fixe peut être déplacée ailleurs et un numéro de téléphonie par internet peut être utilisé n’importe où : c’est un indice, pas une localisation.
Pourquoi un numéro mobile n’a-t-il pas de zone ?
Les tranches mobiles sont nationales : les premiers chiffres indiquent seulement qu’il s’agit d’une ligne mobile, pas où elle a été ouverte ni quel opérateur la gère aujourd’hui.
Ces informations sont-elles officielles ?
Oui. Elles proviennent du plan de numérotation publié par le régulateur du pays ou par l’ITU, et sont mises à jour quand le plan change.
