TeleSignMobileContinuous Trust™
Developer Documentation & API Sandbox

Build with Enterprise Carrier APIs

Integrate digital identity intelligence, omnichannel verification, and global messaging with modern REST endpoints and lightweight SDKs. Test real requests live in our interactive sandbox.

Interactive Request Sandbox

Interactive Live API Sandbox
POSThttps://api.telesignmobileltd.com/v1/phoneid/+14158902341
REQUEST BODY (JSON)Content-Type: application/json
{
  "phone_number": "+14158902341",
  "addons": {
    "sim_swap": true,
    "contact_match": true
  }
}
GATEWAY RESPONSE
200 OK|38ms
{
  "reference_id": "TS-8849201-US",
  "status": {
    "code": 300,
    "description": "Transaction successfully completed"
  },
  "phone_type": {
    "code": "1",
    "description": "VALID_MOBILE"
  },
  "carrier": {
    "name": "Verizon Wireless",
    "country_code": "US"
  },
  "risk": {
    "score": 42,
    "level": "LOW",
    "recommendation": "APPROVE"
  }
}

Official Client SDKs

Node.js / TypeScriptv3.2.0
npm install @telesign/sdk
Pythonv3.1.4
pip install telesign
Gov1.4.2
go get github.com/telesign/go-sdk
Javav3.0.0
mvn dependency:get -Dartifact=com.telesign:sdk:3.0.0

Integration Code Samples

Developer Integration Suite
REQUEST PAYLOAD
curl -X POST https://api.telesignmobileltd.com/v1/phoneid/+14158902341 \
  -H "Authorization: Basic ${TELESIGN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "addons": {
      "sim_swap": true,
      "contact_match": true
    }
  }'
SIMULATED JSON RESPONSE (200 OK)Live Gateway
{
  "reference_id": "TS-984218-0012A",
  "status": {
    "code": 300,
    "description": "Transaction successfully completed"
  },
  "phone_type": {
    "code": "1",
    "description": "VALID_MOBILE"
  },
  "carrier": {
    "name": "Verizon Wireless",
    "country_code": "US"
  },
  "risk": {
    "score": 42,
    "level": "LOW",
    "recommendation": "APPROVE"
  },
  "sim_swap": {
    "risk_indicator": "NONE",
    "last_swap_date": null
  }
}

Real-Time Webhooks & Callbacks

Real-Time Webhook Event Dispatcher
EVENT PAYLOAD POSTED TO YOUR WEBHOOK LISTENERSigned with HMAC-SHA256
{
  "event": "verify.delivery_receipt",
  "event_id": "evt_9841289410",
  "timestamp": "2026-11-20T08:14:22Z",
  "data": {
    "reference_id": "VR-99201-US",
    "recipient": "+14158902341",
    "channel": "whatsapp",
    "delivery_status": "DELIVERED_TO_HANDSET",
    "latency_ms": 680
  }
}

Standard Gateway Status & Error Codes

100DELIVERED
Message or OTP successfully transmitted to carrier
200QUEUED
Request accepted and routed across optimal telecom gateway
300SUCCESS
Identity evaluated and reputation score computed
401UNAUTHORIZED
Invalid Customer ID or API authorization signature
429RATE_LIMITED
Exceeded allocated concurrent requests per second

Need Production API Keys?

Get instant sandbox credentials with 5,000 free test requests.

Create Free Developer Account