CallerAPI Documentation
    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)

    Quckstart

    Stop Spam Calls
    Score inbound/outbound numbers and auto-block high-risk calls.
    Prevent Porting Fraud
    Detect recent port-out/SIM-swap signals before you trust a number.
    Verify Reachability
    Check HLR and presence (WhatsApp, Telegram, etc.) to route smarter.
    Talk to an expert
    Make your telco spam-free by integrating CallerAPI.

    Who is CallerAPI for?#

    CallerAPI helps carriers, CPaaS platforms, cloud comms/SIP providers, PBX & UCaaS vendors, and consumer apps stop revenue-draining spam, block account takeover, and cut messaging costs with real-time phone intelligence. Use it to decide “Should I trust this number, connect this call, send this message, or ask for more verification?”

    Get an API key#

    Get started → Dashboard → Copy API Key
    Keep it safe; pass it in the x-auth header like this:
    x-auth: YOUR_CALLERAPI_KEY

    Make your first request#

    get_callerapi_key.gif
    Or with cURL/code:
    cURL
    Node.js
    Python
    PHP

    Interpret the response#

    All the API responses are returned in JSON format. This would be a response for the previous API call:
    {
      "credits_left": 9691567,
      "credits_monthly": 9999999,
      "credits_spent": 308432,
      "email": "you@company.com",
      "status": "success"
    }
    Modified at 2025-08-08 22:17:33
    Next
    For carriers (MNOs/MVNOs)
    Built with