1. Business Caller ID
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
    • Voice firewall
      • Get started
      • Quickstart
        • What you get
        • Before you start
        • Test with a recording
        • Connect your switch
        • Switch notes
        • Twilio and Telnyx
        • Send text instead of audio
      • Verdicts
        • Read a verdict
        • What to do with a verdict
        • Block a caller
        • Events and webhooks
      • Honeypot
        • Hand a call over
        • Audio, events, and limits
      • Reference
        • Endpoints
        • Errors
        • Limits and thresholds
        • Production checklist
      • REST
        • What this deployment can do
        • List the verdict categories
        • List the honeypot personas
        • Score a transcript or a recording
        • List your recent sessions
        • Get one session with verdict and intel
        • Twilio voice URL for a screened number
        • Preview the Twilio TwiML
        • Telnyx voice URL for a screened number
        • Twilio voice URL for a honeypot number
        • Telnyx voice URL for a honeypot number
      • WebSocket
        • Live scam filter stream
        • Honeypot stream
    • 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
    • 15 days spam CSV snapshot
      GET
    • Spam score + HLR
      GET
  • Mobile SDK
    • Get started
    • Quickstart
      • What you get
      • Get your keys
      • Android
      • iOS
      • Flutter
      • React Native
      • Check it works
    • Call screening
      • What each platform can do
      • Android call screening
      • iOS prerequisites
      • iOS add the extension
      • iOS test on device
    • Reference
      • Methods
      • Errors
      • Limits and billing
      • Troubleshooting
  • Data partners
    • Partner tems & docs
    • Upload spam reports
      POST
    • Upload contacts
      POST
  • Fraud prevention
    • Ported date
      GET
    • Porting history
      GET
    • Online presence
      GET
    • KYC user identity
      POST
  • Business Caller ID
    • Get started
    • Quickstart
      • Announce a call
      • Verify at INVITE
      • What you get
    • Verdicts
      • Show the name and logo
      • Read a verdict
    • REST
      • Verify the calling number
      • Fetch the logo
      • Announce a call
  • Signer reputation by SPC
    GET
  • Signers ranked by score
    GET
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
    • Signer
  1. Business Caller ID

Get started

Business Caller ID tells a terminating switch whether the calling number is presented by the business that registered it. You ask at INVITE, before the phone rings. The answer is proof. It is not a reputation score.
A lookup keyed on the number returns the same name to a spoofer as it does to the owner. This check does not. The owner announces each call with a publish token. A spoofer cannot mint that announcement.
The business pays 2 credits for each announcement. Verify is free for the telco. When the verdict is verified, the telco receives 1 credit. Do not put a business API key on the switch.
Falcon verifies this by default when a CallerAPI key is set. If the switch can inject headers, Falcon sets X-Falcon-BCID, X-Falcon-BCID-Name, and Remote-Party-ID.

Pick your path#

Path 1: verify inbound calls#

Your switch sends the calling number and the called number. You get a verdict and a recommended action.
Go to Verify at INVITE.

Path 2: announce outbound calls#

Your dialler announces the call as it dials. Do not put the publish token in a SIP header.
Go to Announce a call.

What you need#

1.
Your API key from the dashboard. Use it in the x-auth header for verify and for logos.
2.
For path 2, a publish token from the dashboard. The token is shown once. The business account must have credits. Announce costs 2 credits.
3.
Logos cost nothing.

What this is not#

Spam score + HLR can return a business name. That is a name on a number. It is not proof that this call came from that business.
Modified at 2026-09-21 16:59:53
Previous
KYC user identity
Next
Announce a call
Built with