ShadyCall API

Look up a number

GET https://shadycall.com/api/v1/number/2125550123

Any common format works in the path: 2125550123, 12125550123, 212-555-0123, 18005550199, 011447911123456.

Response

{
  "number": "2125550123",
  "display": "(212) 555-0123",
  "international": "+12125550123",
  "type": "geographic",          // geographic | tollfree | premium | canada | caribbean | territory | nongeo | international
  "typeLabel": "US phone number",
  "location": "New York, NY",    // where the exchange was assigned (NANPA)
  "carrier": "Verizon Wireless", // the original carrier of the exchange; numbers can be ported
  "lineType": "wireless",        // wireless | landline | voip | paging (a best guess from the carrier)
  "verdict": "bad",              // bad | caution | safe | unknown
  "verdictLabel": "Shady call",
  "score": 87,                   // 0 (safe) to 100 (shady call); null when nothing is known
  "complaints": 41,              // FTC + FCC consumer complaints
  "ftcComplaints": 33,
  "fccComplaints": 8,
  "robocallComplaints": 29,
  "topSubject": "Medical & prescriptions",
  "lastComplaint": "2026-11-09T20:11:25Z",
  "reports": 12,                 // ShadyCall community reports
  "badReports": 10,
  "unsureReports": 1,
  "safeReports": 1,
  "smsReports": 4,
  "topCategory": { "key": "health-insurance", "label": "Health insurance / Medicare" },
  "callerNames": [ "Medicare benefits" ],
  "firstReported": "2026-10-02T03:14:00Z",
  "lastReported": "2026-10-30T22:41:00Z",
  "url": "https://shadycall.com/number/2125550123",
  "attribution": "Data from ShadyCall ..."
}

Rules

• Free, no key, CORS enabled for browsers.
• Up to 300 requests an hour per address (HTTP 429 beyond that). Responses can be cached for 10 minutes.
• Show a visible link to the number's url wherever you display the data, such as "Reports from ShadyCall".
• Complaint data is what consumers told the FTC and FCC, not verified findings. Don't present it as proof of who owns or called from a number.
• Don't use it to build contact lists or to harass anyone. Full terms.

Other feeds

• RSS feed of the latest community reports.
• Sitemap of every number, area code and exchange page.
• llms.txt: for AI assistants citing ShadyCall.

Need more volume, or a bulk feed? Tell us what you're building.