API Documentation — WhatAScam – Report, Search & Verify Scams

Overview

The WhatAScam REST API provides access to our scam database, blacklists, and reports. Some endpoints are public; others require an approved API key.

Base URL

https://whatascam.org/api/v1/public

Authentication

API key via X-API-Key header or api_key query param

Response Format

JSON — {"status":"success","data":{...}}

Rate Limit

100 requests/hour (default, configurable per key)

GET action=stats 🌐 Public Get platform statistics

https://whatascam.org/api/v1/public?action=stats

GET action=categories 🌐 Public Get all scam categories with counts

https://whatascam.org/api/v1/public?action=categories

GET action=subcategories 🌐 Public Get subcategories for a category

https://whatascam.org/api/v1/public?action=subcategories&category_id=17

📋 Params: category_id (int) required

GET action=scams 🌐 Public List reports with filters

https://whatascam.org/api/v1/public?action=scams&type=scam&threat=high&country=India&state=HP&page=1&limit=12

📋 Params: type, threat, category, country, state, district, q, page, limit

GET action=scam 🌐 Public Get single report by slug or id

https://whatascam.org/api/v1/public?action=scam&slug=fake-investment-broker

📋 Params: slug or id

GET action=check 🌐 Public Check phone/email/wallet/website

https://whatascam.org/api/v1/public?action=check&q=+919876543210

GET action=phones 🌐 Public Paginated phone blacklist

https://whatascam.org/api/v1/public?action=phones&limit=50&page=1

📋 Params: limit (max 100), page

GET action=wallets 🔑 API Key Required Paginated crypto wallet blacklist

https://whatascam.org/api/v1/public?action=wallets&limit=50

📋 Params: limit (max 100), page

GET action=missing_persons 🔑 API Key Required Missing persons reports

https://whatascam.org/api/v1/public?action=missing_persons&missing_status=missing

📋 Params: missing_status, page, limit

POST action=submit_report 🔑 API Key Required Submit a new report

https://whatascam.org/api/v1/publicPOST body

📋 Params: title*, description*, report_type, threat_level

📝 Example: Check a Phone Number

curl "https://whatascam.org/api/v1/public?action=check&q=%2B919876543210"

// Response:
{
  "status": "success",
  "data": {
    "found": true,
    "type": "phone",
    "phone_blacklist": {
      "phone": "+919876543210",
      "scam_type": "KYC Fraud",
      "reports": 12,
      "country": "India"
    },
    "reports": [...]
  }
}

🔑 API Documentation

Overview

📝 Example: Check a Phone Number