Référence API

Authentification

Créez une API key dans votre compte et copiez la valeur affichée une seule fois. Configurez NOCALL_API_KEY comme secret sur votre serveur. Utilisez HTTPS ; ne mettez jamais la clé dans le code du navigateur, les dépôts, captures ou journaux.

Envoyez la clé complète dans Authorization: Bearer, avec un espace après Bearer. N’utilisez pas X-API-Key et ne placez pas la clé dans l’URL.

Sur /v1/data/* + /v2/*, une clé valide remplace la preuve ByteGuard du navigateur. Expiration, révocation, abonnement, crédits et limites restent contrôlés. Elle n’autorise pas les autres routes. openapi.json et products sont publics.

Authorization: Bearer <NOCALL_API_KEY>

• Créer une clé API ↗

Votre première requête

Les 44 tools sont tous disponibles via l’API : appelez POST /v2/<tool-id>, ou POST /v2/tools avec le champ tool dans le corps. Chaque tool a son propre corps JSON, documenté dans son guide. data.result contient le résultat du tool. Utilisez les identifiants du tableau.

Générez une nouvelle Idempotency-Key pour chaque nouvelle opération. Conservez cette clé uniquement pour réessayer la même opération avec les mêmes données.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/tools' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"tool":"who-calls","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/tools',
    method='POST',
    data=json.dumps({'tool': 'who-calls', '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/tools', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ tool: 'who-calls', 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);

API v2 · tools

Les 44 tools sont tous disponibles via l’API : appelez POST /v2/<tool-id>, ou POST /v2/tools avec le champ tool dans le corps. Chaque tool a son propre corps JSON, documenté dans son guide. data.result contient le résultat du tool. Utilisez les identifiants du tableau.

• OpenAPI v2 ↗

Endpoints disponibles

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.

API v1 · phone est obligatoire : une chaîne de 64 caractères maximum, de préférence au format E.164. country est un code pays pris en charge à deux lettres, facultatif, avec ES par défaut. Content-Type doit être application/json.

• OpenAPI 3.1 ↗

Réponses

data contient le résultat ; meta fournit requestId, unitsCharged et l’utilisation si applicable. L’extrait fictif montre le solde après une requête. Un résultat valide sans données coûte aussi 1 crédit ; les erreurs de validation ou de fournisseur et la lecture du solde ne sont pas facturées. L’absence de données ne prouve pas qu’un numéro est sûr. Les schémas complets figurent dans OpenAPI.

{
  "data": {
    "tool": "who-calls",
    "result": {
      "phoneNumber": "+12025550123",
      "found": true,
      "updatedAt": "2026-10-01T09:30:00.000Z",
      "risk": {
        "score": 72,
        "level": "high"
      },
      "reportCount": 14,
      "categories": [
        "TELEMARKETING"
      ],
      "verified": false,
      "carrier": null,
      "verifiedBusiness": null
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

• OpenAPI v2 ↗

Crédits et limites

Chaque appel à l'API coûte 1 crédit. Les crédits mensuels sont utilisés en premier.

La régénération désactive vos anciennes clés. Votre solde de crédits est conservé.

curl 'https://api.nocall.io/v1/data/account' \
  --header "Authorization: Bearer $NOCALL_API_KEY"

• Clé API et crédits ↗

Nouvelles tentatives et lots

Générez une nouvelle Idempotency-Key pour chaque nouvelle opération. Conservez cette clé uniquement pour réessayer la même opération avec les mêmes données.

Idempotency-Key est facultatif pour une requête individuelle et obligatoire pour un lot : 8 à 128 caractères (lettres, chiffres, points, tirets, traits de soulignement ou deux-points). Pour réessayer, gardez la même clé, route, API key et le même corps. Une réponse rejouée n’est pas refacturée. Vérifiez le solde après une réponse ambiguë.

Un lot accepte jusqu’à 50 entrées. product choisit une opération de l’exemple. Le solde doit couvrir toutes les entrées valides avant de commencer ; seuls les résultats valides terminés sont facturés. Les requêtes simultanées partagent le solde : s’il est épuisé avant le débit final, la requête renvoie 429 sans être facturée.

8–128 ASCII: A–Z a–z 0–9 . _ : -
TTL: 24 h

phone-lookup
phone-risk
carrier-lookup
reverse-phone-lookup
phone-exposure

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v1/data/bulk-lookups' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"product":"phone-risk","inputs":[{"phone":"+12025550123","country":"US"}]}'

Résoudre un problème

Guides associés

• Renseignement téléphonique
• Risque téléphonique
• Recherche opérateur
• Mon numéro a-t-il fuité ?
• Recherche inversée d’entreprise vérifiée