TelCheckTelCheck

Developers

API Documentation

Integrate TelCheck into your applications

Free
No key needed
Secure
HTTPS
REST
JSON API

Base URL

https://api.telcheck.fr

Authentication

The public API is free and requires no key. For heavy usage, contact us.

Score → Risk level

1 – 4
Trustworthy
5
Neutral
6 – 9
Suspicious
—
Unknown
GET
/api/phone/:number

Returns the full report for a number: score, technical info, and community comments.

Example
$curl https://api.telcheck.fr/api/phone/0756957054
Response schema
FieldTypeDescription
numberstringNormalized number
phoneInfo.nationalstringNational format
phoneInfo.typestringLine type (mobile, fixed_line…)
sources.primary.scorenumber | nullScore 1–9 (1–4=safe, 5=neutral, 6–9=suspicious)
sources.primary.searchesnumberSearch count
sources.primary.commentListarrayComments with author, text, date
sources.community.dangerPercentnumber | nullCommunity danger percent (0–100)
sources.community.visitsnumber | nullVisit count
sources.signals.spamScorenumber | nullSpam score 0–100
sources.signals.reportsCountnumber | nullReport count
Example response
{
  "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": []
      }
    }
  }
}
Response structure
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

Returns only the reputation score and risk level.

Example
$curl https://api.telcheck.fr/api/phone/0756957054/score
Response schema
FieldTypeDescription
numberstringNumber
scorenumber | nullScore 1–9
risk"trustworthy" | "neutral" | "suspicious" | "unknown"Level
Example response
{
  "success": true,
  "data": {
    "number": "0756957054",
    "score": 7,
    "risk": "suspicious"
  }
}
Response structure
100%
2 nodes
rootobject{2}
success:true
data:object{3}→
dataobject{3}
number:"0756957054"
score:7
risk:"suspicious"
GET
/health

Service availability check.

Example
$curl https://api.telcheck.fr/health
Response schema
FieldTypeDescription
status"ok"Service status
uptimenumberUptime in seconds
Example response
{
  "status": "ok",
  "uptime": 3600,
  "timestamp": "2026-05-23T12:00:00.000Z"
}
Response structure
100%
1 nodes
rootobject{3}
status:"ok"
uptime:3600
timestamp:"2026-05-23T12:00:00.000Z"

Error codes

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