Upload spam reports

POST

/api/partners/complaints/upload

INFO

This endpoint is only available to selected data partners (e.g. caller id apps), schedule a meeting, in return we will provide the spam protection API for free

Upload spam reports to CallerAPI database

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://callerapi.com/api/partners/complaints/upload' \
--header 'Content-Type: application/json' \
--header 'x-auth;' \
--data-raw '[
    {
        "PhoneNumber": "+14155551234",
        "CreatedDate": "2025-02-28T19:03:50Z",
        "ViolationDate": "2025-02-28T15:05:00Z",
        "ConsumerState": "Maryland",
        "Subject": "Other",
        "RecordedMessageOrRobocall": "Y",
        "Comment": "User reported repeated robocalls"
    },
    {
        "PhoneNumber": "+12125551234",
        "CreatedDate": "2025-02-28T19:10:00Z",
        "ViolationDate": "2025-02-28T18:55:00Z",
        "ConsumerState": "California",
        "Subject": "Telemarketing",
        "RecordedMessageOrRobocall": "N",
        "Comment": ""
    }
]'

Response Example

200 - Successful upload

{
    "failed": 0,
    "inserted": 2,
    "status": "success"
}

Request

Authorization

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

Modified at 2025-08-13 23:08:47

KYC user identity

Upload contacts