Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 ReputationWith Number Reputation
Calls flagged “Spam Likely”Spam risk level: low / medium / high
No visibility into why4 granular scores (0–100)
Manual checkingAutomated monitoring on a schedule
No historical trackinglast_refreshed_at timestamps
Reputation data is powered by Hiya — AT&T’s primary spam analytics partner and the engine behind AT&T ActiveArmor. When you register numbers, Hiya registers them across all three major analytics engines (Hiya, First Orion, TNS).

​
How it works

  1. Register your business as an Enterprise
  2. Upload a signed LOA (Letter of Authorization) via the Documents API
  3. Enable Number Reputation — your details are sent to Hiya for automated vetting (takes minutes)
  4. Associate phone numbers for monitoring (up to 100 per request, US local, E.164)
  5. Query reputation scores — cached results are free, fresh (live) queries are billed
  6. Automatic monitoring re-checks your numbers on a configurable schedule
No changes to your call control integration are required. Number Reputation is a standalone monitoring product.

​
Constraints

ConstraintLimit
Phone number formatE.164, US local numbers only
Numbers per request100 (atomic — all-or-nothing)
Score range0–100 (null = insufficient data)
Account accessVerified and enterprise-level accounts only