Phone number scam lookup API

curl "https://api.bewary.app/v1/phone/%2B18008291040"

import requests

r = requests.get("https://api.bewary.app/v1/phone/%2B18008291040", timeout=10)
result = r.json()
print(result["verdict"], result["p_scam"], result["reason_codes"])

const res = await fetch("https://api.bewary.app/v1/phone/%2B18008291040")
const result = await res.json()
console.log(result.verdict, result.p_scam, result.reason_codes)

import os, requests
from urllib.parse import quote

def caller_label(number):
    key = os.environ["BEWARY_API_KEY"]          # a free key: bewary.app/account
    headers = {"Authorization": f"Bearer {key}"}
    r = requests.get("https://api.bewary.app/v1/phone/" + quote(number), headers=headers, timeout=10)
    r.raise_for_status()
    result = r.json()
    if result["entities"][0]["facts"]["listed"]:
        return "Reported for scam calls"
    return None                            # no label: not listed is not proof of safe

print(caller_label("+18008291040"))

import type { Envelope } from "./bewary"

export async function callerLabel(number: string): Promise<string | null> {
  const key = process.env.BEWARY_API_KEY!     // a free key: bewary.app/account
  const headers: Record<string, string> = { Authorization: `Bearer ${key}` }
  const res = await fetch("https://api.bewary.app/v1/phone/" + encodeURIComponent(number),
    { headers, signal: AbortSignal.timeout(10_000) })
  if (!res.ok) return null
  const e = (await res.json() as Envelope).entities[0]
  return e.type === "phone" && e.facts.listed ? "Reported for scam calls" : null
}

{  "schema_version": "1.7.0",  "request_id": "req_01M69WHKA2ETH25TQA4J813VRP",  "checked_at": "2026-10-31T21:06:15Z",  "engine": "bewary-engine/3.0.0",  "models": {    "calibration": "interim-band-v0"  },  "input": {    "kind": "lookup",    "channel": "unknown",    "language": null,    "region": null  },  "verdict": "unknown",  "p_scam": 0.2,  "risk_score": 20,  "confidence": 0,  "classification": null,  "reason_codes": [],  "entities": [    {      "id": "e1",      "type": "phone",      "value": "+18008291040",      "normalized": "+18008291040",      "role": "mentioned",      "verdict": "unknown",      "p_scam": 0.2,      "risk_score": 20,      "reason_codes": [],      "facts": {        "e164": "+18008291040",        "country": "US",        "number_type": "toll_free",        "original_carrier": null,        "line_type": null,        "complaints": {          "ftc": null,          "fcc": null,          "callbacks": null,          "pushed_by": null        },        "honeypot_hits_30d": 0,        "listed": false,        "public_listing": null,        "indexable": false,        "target_countries": null,        "list_count": null      },      "related": [],      "datasets": [        {          "dataset": "phone_numbering",          "coverage": "WW",          "in_coverage": true        },        {          "dataset": "us_numbering",          "coverage": "US",          "in_coverage": true        },        {          "dataset": "phone_complaints",          "coverage": "US",          "in_coverage": true        },        {          "dataset": "honeypot_lines",          "coverage": "US",          "in_coverage": true        },        {          "dataset": "phone_reports_de",          "coverage": "DE",          "in_coverage": false        },        {          "dataset": "community_reports",          "coverage": "WW",          "in_coverage": true        }      ]    }  ],  "signals": [],  "degraded": false,  "degraded_reasons": [],  "cached": false,  "explanation": null}