CallerAPI Documentation
  1. Spam protection
CallerAPI Documentation
  • Quckstart
  • Use cases
    • For carriers (MNOs/MVNOs)
    • CPaaS platforms
    • Cloud communications providers
    • SIP trunking providers
    • PBX/Cloud PBX
    • UCaaS vendors
  • Account
    • Balance and email
      GET
  • Spam protection
    • Spam score + HLR
      GET
    • Fetch daily spam reports
      GET
  • Fraud prevention
    • Ported date
      GET
    • Porting history
      GET
    • Online presence
      GET
    • KYC user identity
      POST
  • Data partners
    • Upload spam reports
      POST
    • Upload contacts
      POST
  • Voice
    • Coming soon...
  • SMS
    • Coming soon...
  • SIP Trunking
    • Coming soon...
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
  1. Spam protection

Fetch daily spam reports

GET
/api/spam-reports/daily/{country_code}
INFO
This endpoint is only available to special enterprise clients, schedule a meeting to discuss the pricing
Fetch the daily spam reports we have collected from multiple sources and validated with our algorhitms and validation team
This endpoint is designed for carriers, telcos and platforms processing over 3 million calls/sms a month, so they can save on volume and own the data
Pricing on this endpoint is flat, no pay-per-request, so you can get a predictable, fixed cost, while retaining all the benefits of the API
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://callerapi.com/api/spam-reports/daily/US?page=1&page_size=1000' \
--header 'x-auth;'
Response Response Example
200 - Daily reports (truncated to 2 instead of 500)
{
    "data": {
        "complaints": [
            {
                "PhoneNumber": "+13072699147",
                "CreatedDate": "2025-08-05T01:03:54Z",
                "ViolationDate": "2025-09-04T13:01:00Z",
                "ConsumerState": "Wyoming",
                "Subject": "Other",
                "RecordedMessageOrRobocall": "Y",
                "Comment": ""
            },
            {
                "PhoneNumber": "+16892090312",
                "CreatedDate": "2025-08-05T22:17:40Z",
                "ViolationDate": "2025-08-05T22:16:00Z",
                "ConsumerState": "Kentucky",
                "Subject": "Other",
                "RecordedMessageOrRobocall": "N",
                "Comment": "Silent call"
            }
        ],
        "date": "06/08/2025",
        "next_update": 1754571630,
        "next_update_in": 67171.961994378,
        "page": 1,
        "page_size": 500,
        "total": 18828
    },
    "status": "success"
}

Request

Authorization
API Key
Add parameter in header
x-auth
Example:
x-auth: ********************
or
Path Params

Query Params

Responses

🟢200OK
application/json
Body

🟠401Unauthorized
Modified at 2025-08-16 00:31:53
Previous
Spam score + HLR
Next
Ported date
Built with