Overview
Number Reputation gives you programmatic access to spam reputation data for your outbound calling phone numbers. Instead of guessing why calls get flagged as “Spam Likely,” you get real-time scores and risk levels — letting you identify and fix flagged numbers before they impact your answer rates.| Without Number Reputation | With Number Reputation |
|---|---|
| Calls flagged “Spam Likely” | Spam risk level: low / medium / high |
| No visibility into why | 4 granular scores (0–100) |
| Manual checking | Automated monitoring on a schedule |
| No historical tracking | last_refreshed_at timestamps |
How it works
- Register your business as an Enterprise
- Upload a signed LOA (Letter of Authorization) via the Documents API
- Enable Number Reputation — your details are sent to Hiya for automated vetting (takes minutes)
- Associate phone numbers for monitoring (up to 100 per request, US local, E.164)
- Query reputation scores — cached results are free, fresh (live) queries are billed
- Automatic monitoring re-checks your numbers on a configurable schedule
Constraints
| Constraint | Limit |
|---|---|
| Phone number format | E.164, US local numbers only |
| Numbers per request | 100 (atomic — all-or-nothing) |
| Score range | 0–100 (null = insufficient data) |
| Account access | Verified and enterprise-level accounts only |