Sur cette page

Appels et numéros

Recherche opérateur

API · ProBêta

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’outil
Sur cette page

Objectif

Saisissez un numéro pour consulter des données approuvées et limitées par la confidentialité.

Informations sur l'opérateur · Type : · Province :.

Prérequis

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

Saisissez le numéro complet avec son indicatif international. Pour un numéro national, vérifiez le pays de l’édition ou du sélecteur.

Mode d’emploi

  1. Ouvrir l’outil

  2. Saisissez le numéro complet avec son indicatif international. Pour un numéro national, vérifiez le pays de l’édition ou du sélecteur.

  3. Vérifier

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

Exemple fictif

Remarque

Exemple inventé, pas une recherche réelle. N’appelez pas et n’ouvrez pas ses liens.

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.

Informations sur l'opérateur · Type : · Province :.

Ce numéro ne figure pas dans notre base de données. Soyez le premier à le signaler.

Seules les données techniques vérifiées ou publiques sont affichées. Les identités privées et signaux de protection restent masqués.

Limites

Attention

Seules les données techniques vérifiées ou publiques sont affichées. Les identités privées et signaux de protection restent masqués.

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.

Informations basées sur les signalements de la communauté et une analyse automatisée. Elles peuvent contenir des erreurs ou être obsolètes, et ne constituent ni un conseil juridique ni une accusation vérifiée contre le propriétaire du numéro.

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.

Numéro de téléphone invalide

Le contrôle de sécurité ou la connexion à l'API n'a pas répondu à temps. Réessayez dans quelques secondes.

Vous avez utilisé toutes les recherches de numéros de téléphone autorisées aujourd'hui. Veuillez réessayer demain.

Utiliser avec l’API

Attention

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.

Remarque

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.

Opérateur attributaire et données de numérotation issues du registre espagnol de la CNMC, ou des données des régulateurs importées pour les autres pays (opérateur, type de numéro, préfixe, région, catégorie de coût). found ne vaut true que lorsqu’un opérateur est nommé.

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.

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

Paramètres

NomTypeObligatoireDescription
phonestring (1–40)OuiNuméro de téléphone au format E.164 (+34…) ou national.
countrystring (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.
bash
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"}'

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.

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

Champs du résultat (data.result)

ChampTypeDescription
phoneNumberstringLe numéro au format E.164.
foundbooleanIndique si NoCall dispose de données réelles sur ce numéro : un opérateur nommé, une entrée de liste de blocage ou d’annuaire, des signalements approuvés ou une entreprise vérifiée. Les données du préfixe seules ne comptent pas. false reste un résultat abouti.
updatedAtstring | nullDate de la dernière mise à jour des données (ISO 8601), ou null.
carrierobject | nullDonnées d’opérateur issues du registre espagnol de la CNMC ou du régulateur du pays : opérateur, type de numéro, préfixe, région et catégorie de coût. null si inconnues.