Phone Intelligence

Endpoints for phone number verification and SIM swap detection.

Phone Signals in Check

Include phone in your /check request:

curl -X POST https://api.simplr-ai.com/v1/check \
  -H "X-API-Key: sk_live_xxxxx" \
  -d '{"phone": "+14155551234"}'

Response includes phone signals:

{
  "content": {
    "signals": {
      "phone": {
        "is_valid": true,
        "carrier": "Verizon",
        "line_type": "mobile",
        "country_code": "US",
        "recent_sim_swap": false,
        "sim_swap_date": null,
        "ported": false,
        "ported_date": null
      }
    }
  }
}

Phone Signal Fields

Field	Type	Description
is_valid	boolean	Phone format is valid
carrier	string	Current carrier name
line_type	string	mobile, landline, voip
country_code	string	ISO country code
recent_sim_swap	boolean	SIM swap in last 7 days
sim_swap_date	string	Date of last SIM swap
ported	boolean	Number was ported
ported_date	string	Date of last port

POST /check/phone/report

Report a fraud outcome to improve ML models:

curl -X POST https://api.simplr-ai.com/v1/check/phone/report \
  -H "X-API-Key: sk_live_xxxxx" \
  -d '{
    "phone": "+14155551234",
    "outcome": "fraud",
    "check_id": "chk_abc123"
  }'

Parameter	Type	Required	Description
phone	string	Yes	Phone number
outcome	string	Yes	fraud, sim_swap_fraud, account_takeover, spam, bot, or legitimate
check_id	string	No	Associated check ID
confidence	number	No	Confidence from 0–100 (default 100)
metadata	object	No	Outcome context