CallerAPI Documentation
  1. Spam protection
CallerAPI Documentation
  • Quickstart
  • 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
    • Daily spam reports
      • Webhook
        • Subscribe to daily reports
        • Unsubscribe from daily reports
        • List webhook subscriptions
        • Manual dispatch of reports
        • Test webhook
      • REST
        • Fetch daily spam reports
    • Spam score + HLR
      GET
  • Fraud prevention
    • Ported date
      GET
    • Porting history
      GET
    • Online presence
      GET
    • KYC user identity
      POST
  • Data partners
    • Partner tems & docs
    • Upload spam reports
      POST
    • Upload contacts
      POST
  • 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

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

Query Params

Responses

🟢200OK
application/json
Body

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.callerapi.com/api/lookup/18883578668?hlr=false' \
--header 'x-auth: <api-key>'
Response Response Example
200 - Verified business entity
{
    "data": {
        "business_info": {
            "business_name": "CallerAPI LC",
            "category": "services",
            "city": "Casper",
            "country": "US",
            "industry": "Computer Security-Systems & Services",
            "state": "WY",
            "verified": true
        },
        "complaints": null,
        "entity_type": "BUSINESS",
        "is_spam": false,
        "phone": "+18883578668",
        "reputation": "VERIFIED",
        "spam_score": 0,
        "total_complaints": 0
    },
    "status": "success"
}
Modified at 2025-10-11 23:50:25
Previous
Fetch daily spam reports
Next
Ported date
Built with