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

Spam score + HLR

GET
/api/lookup/{phone}
This endpoint allows you to see the phone number status and entity type (owner)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://callerapi.com/api/lookup/18558659553?hlr=false' \
--header 'x-auth;'
Response Response Example
200 - Verified business entity
{
    "data": {
        "business_info": {
            "business_name": "Lyft Inc",
            "category": "services",
            "city": "San Francisco",
            "country": "US",
            "industry": "Computer Software Publishers & Developers",
            "state": "CA",
            "verified": false
        },
        "complaints": null,
        "entity_type": "BUSINESS",
        "is_spam": false,
        "phone": "+18558659553",
        "reputation": "UNKNOWN",
        "spam_score": 0,
        "total_complaints": 0
    },
    "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-07 15:52:27
Previous
Balance and email
Next
Fetch daily spam reports
Built with