Canadial API — Phone Spam Lookup for Developers

Quick start

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://canadial.com/api/v1/lookup?phone=4165551234"

Example response:

{
  "phone": "4165551234",
  "risk_level": "high",
  "risk_score": 85,
  "type": "Scam",
  "report_count": 47,
  "label": "CRA Impersonation Scam",
  "is_legitimate": false,
  "organization": null,
  "last_reported": "2026-06-15",
  "source": "canadial_community"
}

Authentication

Pass your key as a bearer token in the Authorization header. Get your free API key at canadial.com/api-keys.

Authorization: Bearer YOUR_API_KEY

Endpoints

Risk levels

Rate limits

Every response includes X-RateLimit-Remaining. Over-limit requests return 429.

Code examples

JavaScript / Node.js

const res = await fetch(
  "https://canadial.com/api/v1/lookup?phone=4165551234",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data.risk_level, data.risk_score);

Python

import requests

res = requests.get(
    "https://canadial.com/api/v1/lookup",
    params={"phone": "4165551234"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(res.json()["risk_level"])

PHP

<?php
$ch = curl_init("https://canadial.com/api/v1/lookup?phone=4165551234");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_API_KEY"]);
$data = json_decode(curl_exec($ch), true);
echo $data["risk_level"];

Use cases

• Call blocker apps — screen incoming numbers in real time
• CRM systems — show caller risk before answering
• Senior protection apps — warn vulnerable users about scam calls
• Browser extensions — flag suspicious numbers on web pages