CallerAPI Documentation
  1. Use cases
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. Use cases

CPaaS platforms

Keep your senders clean, keep routes open:#

You live on reputation. One tenant runs a sloppy campaign and the whole range gets flagged. Calls don't connect. Messaging gets throttled. Carriers start asking questions you don't want to answer.
You can't police every customer. You can police what leaves your platform.
NOTE
Where CallerAPI sits
In your orchestration layer before you originate. For voice, think pre-dial / pre-ACD. For messaging, pre-send. You ask one question: "Should we let this sender/number go out?" We reply with a tier (SPAM / BUSINESS / UNKNOWN) and the why (raw reports, reason codes). You enforce. That's it.

What we're actually fixing#

Delivery & connect rate: stop bad traffic before it tanks everyone's results.
Brand trust: keep legitimate business callers from wearing "Spam Likely."
Carrier relations: fewer complaints, fewer audits, better throughput when it matters.

How you run it (boring and predictable)#

CaseDefault actionWhat actually happensWhy this is sane
SPAMBlockDon't originate. Show the reason to the tenant.Protects routes. Stops obvious abusers, fast.
BUSINESS, but with recent spam reportsChallengeAdd light friction: captcha/IVR gate, throttle, or require sender verification.Humans comply. Bots and spammers don't.
UNKNOWNAllowOriginate normally; monitor early signals.Most new senders are fine.
WARNING
Start conservative. Put the gray zone in Challenge, not Block. Tighten after a week of data.

Day-1 to Day-30 - the playbook#

1
Week 1 - Pilot and test
Score every outbound call/message. Don't enforce yet. Surface the tier and reasons to your abuse/ops channel. Build two live lists: "must-pass" senders (critical customers) and "must-block" (repeat abusers).
2
Week 2 - Turn on enforcement
Enforce SPAM = Block for newly-created senders and throwaway accounts. Keep BUSINESS (with recent reports) = Challenge. Show tenants the reason right in your dashboard.
3
Week 3 - Tune by traffic type
Marketing, alerts, two-way contact centers behave differently. Create per-use-case thresholds. If your challenge pass-through is high, you're being too strict.
4
Week 4 - Automate reputation hygiene
Auto-throttle senders that trip medium risk repeatedly. Require extra verification for tenants with poor history. Keep signed decision logs; they end arguments quickly.

What to measure (and how to read it)#

Connect rate / deliverability - up means healthier routes. If it flatlines, widen "SPAM."
Challenge pass-through - low means you're hurting legit traffic; simplify or loosen.
Carrier complaints / traceback pings — should drop. If not, your gray zone needs attention.
Tenant disputes - every block must come with a reason. If you can't show it, don't enforce it.
TIP
Quick win: apply enforcement to new tenants and new senders first. They cause most of the damage with the least upside.

Edge cases you will hit (handle them up front)#

Shared short codes & pooled numbers
Aggressive dialers (predictive/preview)
High-value alerts (banks, 2FA, healthcare)
Snowshoe & look-alike campaigns

Cost & Data Control - "Daily Spam Report" for platforms that want flat spend#

Per-call checks are great when you need context. But some CPaaS teams want predictable cost and a dead-simple ingest: one pull a day, curated intelligence, platform-wide.
What you get
A daily set of confirmed spam/abuse numbers and campaigns, validated by our systems and human review. Scope is platform-wide, delivered per tenant.
Why it exists
You want to protect routes without variable bills. One (or a few) fetches per day. Load it. Enforce. Done.
How you use it
Pull today's JSON, push to your reputation cache, and apply the SPAM / BUSINESS / UNKNOWN policy. Curated list, no per-call metering.
Service definition:
Endpoint: a dedicated Daily Spam Report endpoint provisioned per tenant.
Format: JSON.
Fields: number, created date, violated date, consumer state, subject (spam category), robocall (yes/no).
Cutover time: The spam reports are compiled, verified and updated each day before 13:00 UTC, they cover the past 24 hours.
Validation: algorithmic scoring + human review pass on high-impact entries.
Retention: last 24 hours available via the same endpoint.
License: carrier-wide use for inbound controls at your edge.
Price: flat monthly fee (no per-call charges).
Purpose: cost control and predictable ops for very high traffic.
INFO
Ask us to enable Daily Spam Report for your tenant. We'll hand you a hardened URL, auth method, and sample file so your team can wire the nightly job.
You keep control of region and retention on your side.
When to use which mode
Daily Report - budget certainty; works best for global hygiene and route protection.
Real-time - use when you need per-send context (tenant tier, content type, campaign window) and want to challenge the gray zone instead of blunt-blocking it.

Platform etiquette with your customers#

Be explicit. "We block obvious garbage. We challenge the gray. We log every decision with the reason and timestamp." Show senders their own reason codes inside your dashboard. It turns angry tickets into quick fixes. And it keeps your carrier partners happy.

Talk to an expert
Make your telco spam-free by integrating CallerAPI.
Modified at 2025-08-08 16:22:11
Previous
For carriers (MNOs/MVNOs)
Next
Cloud communications providers
Built with