Lookup

Look up a number

GET /v1/lookup/+14155550132

{
  "phone_number": "+14155550132",
  "valid": true,
  "line_type": "mobile",
  "carrier": { "name": "Verizon Wireless", "type": "mobile" },
  "caller_name": null
}

Test keys return deterministic fixtures; live keys return real carrier data (cached 24h).

Spam signal

GET /v1/lookup/+14155550132/spam

{
  "phone_number": "+14155550132",
  "spam_score": 87,
  "spam_type": "robocall",
  "severity": "high",
  "last_reported_at": "2026-08-01T12:00:00.000Z",
  "reports": 12
}

Scores come from a 400k-download consumer phone app's real detection graph — millions of screened calls and messages. spam_score is 0–100; anything above 70 was confirmed by our classifier. Aggregates only; report contents are never exposed.

Lookups count against a daily quota (default 250/day live, 100/day sandbox).