Developers

Enterprise Risk API

Payout, onboarding లేదా callback ముందు ఒక phone number spam risk, business verification ను check చేయండి — ఒక signed request, milliseconds లో సమాధానం.

Signed & scoped

HMAC-signed requests, ఒక్కసారే వాడే nonces, IP allowlists, ప్రతి client కు ప్రత్యేక scopes.

ఒకసారి ఒక నంబర్

నిర్ణయాల కోసం — data mining కోసం కాదు. Batch input లేదు, directory export లేదు.

Privacy by design

Verified business పేర్లు మాత్రమే ఇస్తాం. మీరు check చేసే నంబర్లను మేము నిల్వ చేయం.

Request

import hashlib, hmac, json, secrets, time, requests

path = "/enterprise/v1/risk-check"
body = json.dumps({"number": "+918041234567"})
ts, nonce = str(int(time.time())), secrets.token_hex(16)
canonical = "\n".join([ts, nonce, "POST", path,
                        hashlib.sha256(body.encode()).hexdigest()])
sig = hmac.new(SECRET.encode(), canonical.encode(),
               hashlib.sha256).hexdigest()

r = requests.post("https://api.synsafecaller.com" + path, data=body,
    headers={"Content-Type": "application/json", "X-SSC-Key": KEY_ID,
             "X-SSC-Timestamp": ts, "X-SSC-Nonce": nonce,
             "X-SSC-Signature": sig})

200 OKResponse~40 ms

{
  "request_id": "5b1f0c2e-8c4d-4a6e-9d51-2f7c3a9e1b20",
  "number": "+918041234567",
  "verification": {
    "status": "verified_business",
    "business_name": "Acme Bank",
    "purpose": "support"
  },
  "risk": { "level": "low", "confidence": "high", "category": null },
  "ttl_seconds": 3600,
  "v": 1
}

మీకు వచ్చేవి

verification.status: verified_business, claimed లేదా unverified
verification.business_name: Verified businesses కు మాత్రమే — వ్యక్తుల పేర్లు ఎప్పుడూ కాదు
risk.level: unknown, low, medium, elevated లేదా high — community reports, burst detection ఆధారంగా
risk.category: ఎక్కువగా report అయిన వర్గం, ఉదా. loan_fraud లేదా telemarketing

Limits & భద్రత

ప్రతి client కు default గా సెకనుకు 10 requests
Contract ప్రకారం నెలవారీ quota
±5 నిమిషాల timestamp window, nonces మళ్లీ వాడలేరు
Emergency నంబర్లు (112, 100, 108…) ఎప్పుడూ score చేయబడవు

ఎవరి కోసం

బ్యాంకులు, NBFC లు — account వివరాలు చెప్పే ముందు caller ను verify చేయండి
Fintech & payments — payout, refund నంబర్ల risk check
Collections & support teams — callback నంబర్ నిజమైనదో నిర్ధారించండి

API access పొందండి

ఉద్దేశ పరిమితితో contract ద్వారా మాత్రమే access. మీ use case, అంచనా volume మాకు తెలియజేయండి.

మాతో మాట్లాడండి — contact@synsafecaller.com

Python, Node.js, PHP examples తో integration guide ను approved clients కు పంపుతాం.