Skip to main content

​
What it is

The Free Caller Registry is a joint intake run by the three analytics engines that score caller reputation for the major US carriers — Hiya (T-Mobile), TNS (Verizon), and First Orion (AT&T). Registering a number associates it with your business identity, which protects legitimate calling from “Spam Likely” labeling before behavior scoring decides on its own. The registry is free but deliberately manual: a human-paced portal with an email-verification gate, batch limits, and three separate vendor confirmations to track. RevDesk automates the whole flow and exposes it as an API.
Registration is preventive — it establishes who you are with the engines. To clear labels on numbers that are already flagged, use spam-label remediation ($2/number); remediation requires the number to be hosted on RevDesk (port a flagged number in to unlock it). Best practice is both: register everything, remediate the flagged.

​
Two ways numbers get registered

RevDesk-hosted numbers (included)

Every US number provisioned on RevDesk is registered automatically shortly after purchase — included in the number’s monthly price, on by default. Opt out per workspace in Settings → Call Identity → Reputation.

Bring-your-own numbers ($5/number/mo)

Register numbers hosted anywhere — any carrier or CPaaS — through the API. $5 per number per calendar month on your invoice, starting when the registry accepts the submission. No platform fee, no minimums.

​
Quickstart (BYO numbers)

You don’t need any other RevDesk product — sign up, create an API key (Settings → API Keys), add a payment method, and register:
Business identity (name, address, website, contact) defaults to your workspace’s caller-trust profile; override it per request with business_identity when registering on behalf of another business you’re authorized to represent.

​
Authorization attestation

The registry’s terms require that the submitter is authorized to register the numbers for the business they belong to. For BYO numbers the API therefore requires an explicit attestation (attestation.authorized_to_register: true), which RevDesk records with the registration — the exact accepted text, the acting user, and the timestamp. RevDesk-hosted numbers need no attestation; RevDesk is the service provider of record.

​
Lifecycle

Per-engine acknowledgments (hiya, tns, first_orion) are exposed on GET /v1/number-registrations/{id}. Propagation into live carrier spam labeling typically completes within 24–48 hours of submission. Re-registering a live number is free and simply refreshes it (the registry dedupes by number).

​
Webhooks

Subscribe via POST /v1/webhook_subscriptions:
  • registration_submitted — the registry accepted a submission
  • registration_confirmed — first engine acknowledgment arrived
  • registration_failed — a submission failed after retries

​
Billing semantics

  • $5 per BYO number per calendar month, billed as a “Number Registration” line item on your monthly invoice (quantity = your live registrations). Additions start on your next invoice; no proration.
  • First charge when the submission reaches submitted — a failed run never bills.
  • RevDesk-hosted numbers never bill for registration, even when submitted through the API.
  • DELETE /v1/number-registrations/{id} stops future charges immediately. The registry has no un-register operation, so the number’s existing registration with the engines is unaffected — cancellation is a billing and monitoring stop. No refund for the current month.