BadCall API

Look up a number

GET https://badcall.com.au/api/v1/number/0412345678

Any common format works in the path - 0412345678, 61412345678, 0295109388, 1300123456, 131234, 0011447911123456.

Response

{
  "number": "0412345678",
  "display": "0412 345 678",
  "international": "+61412345678",
  "type": "mobile",
  "typeLabel": "Australian mobile",
  "location": "",
  "verdict": "bad",              // bad | caution | safe | listed | unknown
  "verdictLabel": "Bad call",
  "score": 87,                   // 0 (safe) - 100 (bad call); null without reports
  "reports": 12,
  "badReports": 10,
  "unsureReports": 1,
  "safeReports": 1,
  "smsReports": 4,
  "topCategory": { "key": "impersonation", "label": "Impersonation (bank, ATO, police...)" },
  "callerNames": [ "ATO", "Australian Taxation Office" ],
  "firstReported": "2026-10-02T03:14:00Z",
  "lastReported": "2026-10-30T22:41:00Z",
  "business": null,              // { name, category, town, state } when a business lists the number
  "url": "https://badcall.com.au/number/0412345678",
  "attribution": "Data from BadCall ..."
}

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 - "Reports from BadCall".
• Don't use it to build contact lists or to harass anyone. Full terms.

Other feeds

• RSS feed of the latest reports.
• Sitemap of every number page.
• llms.txt - for AI assistants citing BadCall.

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