Sur cette page

Appels et numéros

Combien coûte un rappel ?

API · Pro

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 le numéro qui vous a appelé : nous indiquons le type de numérotation et ce que coûte généralement un rappel. Cela décrit le type de numéro, pas l’appelant.

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. Numéro qui vous a appelé

  2. Vérifier

  3. Type de numérotation

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

Indicatif : le prix final dépend de votre opérateur et de votre forfait.

Numéro surtaxé: Bien plus cher qu’un appel normal ; le service fixe le prix à la minute, hors forfait.

Renseignements téléphoniques (118xx): Frais de mise en relation et prix à la minute élevés ; ils peuvent vous transférer en continuant à facturer.

Coût partagé: Vous payez une partie de l’appel ; beaucoup de forfaits ne l’incluent pas.

Numéro gratuit: Gratuit depuis un fixe ou un mobile.

Réseau satellite ou mondial: Parmi les tarifs à la minute les plus élevés.

Indicatif international à tarif élevé: Indicatif fréquent dans les campagnes d’appels manqués internationaux (wangiri). Facturé comme un appel international, parfois cher.

International: Facturé comme un appel international par votre opérateur.

Fixe ou mobile national: Comme un appel national ; généralement inclus dans votre forfait.

Non reconnu: Nous ne pouvons pas le classer. Vérifiez le prix auprès de votre opérateur avant d’appeler.

Limites

Attention

Indicatif : le prix final dépend de votre opérateur et de votre forfait.

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.

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.

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.

Niveau de coût d’un rappel du numéro (surtaxé, coût partagé, gratuit, international, satellite, wangiri, …) et la plage correspondante du registre.

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

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

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": "callback-cost",
    "result": {
      "tier": "premium",
      "scope": "national",
      "callingCode": null,
      "registry": {
        "prefix": "806",
        "serviceClass": "premium",
        "costClass": "premium",
        "geography": null,
        "indexable": true
      }
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Champs du résultat (data.result)

ChampTypeDescription
tierstring (enum, 9)Niveau de coût d’un rappel du numéro.
scope"national" | "international"Indique si le numéro est national ou international.
callingCodestring | nullIndicatif international, ou null pour un numéro national.
registryobject | nullPlage de numérotation correspondante du registre, ou null.