How to Check the Status of a TFN Registration

Upon TFN registration submission, status can be tracked in real time on the Vonage Dashboard, or programmatically using the TFN Registration APIs.

Using the Vonage Developer Dashboard

  1. Navigate to the Vonage API Dashboard Portal -> Phone Numbers -> Toll-Free Number Registration
  2. Search by TFN, Status, Business Name, or Registration ID.
  3. The real-time status of the TFN is displayed.
  4. Click on TFN to view details of the TFN registration.
  5. Depending upon the status of the TFN, options under Action will be displayed.

Using the API

You can check the status of a TFN Registration by sending a

GET
request to the following endpoints:

  • Retrieve registration details by registration ID: https://api-eu.vonage.com/tfn/v1/registrations/{id}
  • Retrieve all Toll-Free numbers associated with an Account ID: https://api-eu.vonage.com/tfn/v1/numbers

In the response, you will see a status field that contains the status of your registration. The potential values are:

  • "DRAFT"
  • "PENDING_REVIEW"
  • "UPDATES_REQUIRED"
  • "CARRIER_REVIEW"
  • "REGISTERED"
  • "REJECTED"
  • "BLOCKED"

See the API Reference for a full list of parameters.