Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-13261150.7 KB
Spam

Report Spam Number (Public - No Auth)

Report a phone number as spam without requiring API key authentication. Rate limited by IP address instead of API key.

Use cases:

  • Landing pages
  • Public forms
  • Mobile apps where exposing API keys is not desirable
post/api/v1/spam/report/public

Request body

phone_numberstring required
report_type'spam' | 'robocall' | 'scam' | 'telemarketing' | 'fraud' | 'phishing'
detailsstring
sourcestring

Identifier for where the report is coming from

Example request

{
  "phone_number": "15555550123",
  "details": "Caller claimed to be from IRS",
  "source": "my-website"
}

Response

Spam report submitted successfully

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Thank you! Your spam report has been submitted.",
  "data": {
    "phone_number": "+15555550123",
    "report_type": "robocall",
    "total_reports": 5
  }
}