TelCheckTelCheck

Développeurs

Documentation API

Intégrez TelCheck dans vos applications

Gratuit
Aucune clé requise
Sécurisé
HTTPS
REST
JSON API

URL de base

https://api.telcheck.fr

Authentification

L'API publique est gratuite et ne nécessite pas de clé. Pour un usage intensif, contactez-nous.

Score → Niveau de risque

1 – 4
Fiable
5
Neutre
6 – 9
Suspect
—
Inconnu
GET
/api/phone/:number

Retourne le rapport complet pour un numéro : score, informations techniques, et commentaires de la communauté.

Exemple
$curl https://api.telcheck.fr/api/phone/0756957054
Schéma de réponse
ChampTypeDescription
numberstringNuméro normalisé
phoneInfo.nationalstringFormat national
phoneInfo.typestringType de ligne (mobile, fixed_line…)
sources.primary.scorenumber | nullScore 1–9 (1–4=sûr, 5=neutre, 6–9=suspect)
sources.primary.searchesnumberNb de recherches
sources.primary.commentListarrayCommentaires avec auteur, texte, date
sources.community.dangerPercentnumber | null% de danger communautaire (0–100)
sources.community.visitsnumber | nullNombre de visites
sources.signals.spamScorenumber | nullScore spam 0–100
sources.signals.reportsCountnumber | nullNombre de signalements
Exemple de réponse
{
  "success": true,
  "data": {
    "number": "0270234003",
    "phoneInfo": {
      "national": "02 70 23 40 03",
      "e164": "+33270234003",
      "type": "fixed_line",
      "rangeLabel": "Fixe - zone commerciale vérifiée (NPV)",
      "originalCarrier": "Orange",
      "region": "Île-de-France",
      "isNPV": true
    },
    "sources": {
      "primary": {
        "score": 7,
        "searches": 1243,
        "commentsCount": 8,
        "commentList": [
          { "author": "Anonyme", "text": "Démarchage commercial", "date": "15/05/2026", "callerType": "Télémarketing" }
        ]
      },
      "community": {
        "dangerPercent": 75,
        "visits": 170,
        "commentsCount": 1,
        "topCategory": "Dangereux",
        "lastCommentDate": "12/05/2026",
        "commentList": [
          { "text": "Arnaque signalée", "date": "12/05/2026", "category": "Dangereux" }
        ]
      },
      "signals": {
        "spamScore": 82,
        "reportsCount": 14,
        "callerType": "Spam",
        "commentList": []
      }
    }
  }
}
Structure de réponse
100%
12 nodes
rootobject{2}
success:true
data:object{3}→
dataobject{3}
number:"0270234003"
phoneInfo:object{7}→
sources:object{3}→
phoneInfoobject{7}
national:"02 70 23 40 03"
e164:"+33270234003"
type:"fixed_line"
rangeLabel:"Fixe - zone commerciale vérifi…"
originalCarrier:"Orange"
region:"Île-de-France"
isNPV:true
sourcesobject{3}
primary:object{4}→
community:object{6}→
signals:object{4}→
primaryobject{4}
score:7
searches:1243
commentsCount:8
commentList:array[1]→
commentListarray[1]
0:object{4}→
0object{4}
author:"Anonyme"
text:"Démarchage commercial"
date:"15/05/2026"
callerType:"Télémarketing"
communityobject{6}
dangerPercent:75
visits:170
commentsCount:1
topCategory:"Dangereux"
lastCommentDate:"12/05/2026"
commentList:array[1]→
commentListarray[1]
0:object{3}→
0object{3}
text:"Arnaque signalée"
date:"12/05/2026"
category:"Dangereux"
signalsobject{4}
spamScore:82
reportsCount:14
callerType:"Spam"
commentList:array[0]→
commentListarray[0]
GET
/api/phone/:number/score

Retourne uniquement le score de réputation et le niveau de risque.

Exemple
$curl https://api.telcheck.fr/api/phone/0756957054/score
Schéma de réponse
ChampTypeDescription
numberstringNuméro
scorenumber | nullScore 1–9
risk"trustworthy" | "neutral" | "suspicious" | "unknown"Niveau
Exemple de réponse
{
  "success": true,
  "data": {
    "number": "0756957054",
    "score": 7,
    "risk": "suspicious"
  }
}
Structure de réponse
100%
2 nodes
rootobject{2}
success:true
data:object{3}→
dataobject{3}
number:"0756957054"
score:7
risk:"suspicious"
GET
/health

Vérification de disponibilité du service.

Exemple
$curl https://api.telcheck.fr/health
Schéma de réponse
ChampTypeDescription
status"ok"État du service
uptimenumberUptime en secondes
Exemple de réponse
{
  "status": "ok",
  "uptime": 3600,
  "timestamp": "2026-05-23T12:00:00.000Z"
}
Structure de réponse
100%
1 nodes
rootobject{3}
status:"ok"
uptime:3600
timestamp:"2026-05-23T12:00:00.000Z"

Codes d'erreur

400Invalid phone number format
404Route not found
429Too many requests
502All data sources failed