Skip to main content

​
What it is

The Free Caller Registry is a joint intake used by the analytics engines that score caller reputation for major US carriers: Hiya, TNS, and First Orion. Registering a number associates it with the business identity that uses it and helps the engines recognize legitimate calling. RevDesk manages this workflow for eligible US numbers hosted on RevDesk. It is an included part of operating those numbers, not a separate product or a bring-your-own-number registration service.
Registration is preventive. It establishes the business identity behind a number, but it does not guarantee that carriers will never label a call. Calling behavior, complaint rates, consent, and list quality still affect reputation. For a number already labeled, see caller trust.

​
How it works

  1. Add or port an eligible US phone number to RevDesk.
  2. Complete the workspace’s business identity and caller-trust profile.
  3. Confirm the authorization attestation in Numbers → Trust.
  4. RevDesk submits the hosted number and tracks acknowledgments from the registry engines.
The workflow is asynchronous. You can review its status in Numbers → Trust or through the read-only API endpoints.

​
Lifecycle

Use GET /v1/number-registrations to list registrations and GET /v1/number-registrations/{id} to inspect one registration’s latest submission and per-engine acknowledgments. New registrations are created from the authenticated RevDesk number workflow, not through the public API.

​
Webhooks

Subscribe via POST /v1/webhook_subscriptions:
  • registration_submitted: the registry accepted a submission
  • registration_confirmed: the first engine acknowledgment arrived
  • registration_failed: a submission failed after retries
Registration for eligible RevDesk-hosted numbers is included. There is no separate Number Registration subscription or per-number registration line item.