v1

latestOpenAPI 3.0.3Proprietary2026-07-13261150.7 KB
Spam

Report Spam Number (Authenticated)

Report a phone number as spam to the master spam database. Requires API key authentication. Prevents duplicate submissions within 24 hours from the same API key.

post/api/v1/spam/report

Request body

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

Type of spam report

detailsstring

Optional description of the incident

Example request

{
  "phone_number": "15555550123",
  "details": "Automated call about car warranty"
}

Response

Spam report submitted successfully

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Spam report submitted successfully",
  "data": {
    "phone_number": "+15555550123",
    "report_type": "spam",
    "complaint_count": 1
  }
}