TFN Registration API Technical Details

A Toll-Free Number (TFN) is a 10-digit phone number that can be dialed at no charge by the person placing the call, while the recipient bears the charges. For SMS and MMS, message and data rates may apply, and each TFN begins with a distinguishing prefix such as 800, 888, 877, 866, 855, 844, or 833.

Vonage offers TFN voice services in approximately 140 countries. However, only the U.S. and Canada offer TFN voice with “text and picture messaging” capabilities. Registration of TFNs in the US and Canada is required by the wireless carriers (operators) for commercial SMS and MMS messaging without sender limits.

Authentication

The TFN Registration APIs support Basic authentication. Basic authentication uses an encoded API key and secret, and authenticates at the account level.

How does TFN Registration Work?

TFN registration can be completed through the Vonage dashboard, or programmatically using the API. Below is a visual representation of a TFN Registration request flow:

TFN Registration ServiceCustomer DashboardCustomerTFN Registration ServiceCustomer DashboardCustomerCreate Registrationalt[Using the Dashboard][Using the API]Update Registrationalt[Using the Dashboard][Using the API]Get Registration DetailsGet Associated EventsGet TFN Registrations for AccountSubmit FormPOST /v1/registrationsPOST /v1/registrations200 OK (registrationID)Submit FormPATCH /v1/registrations/{id}PATCH /v1/registrations/{id}200 OK (registrationID)GET /v1/registrations/{id}200 OK (details)GET /v1/registrations/{id}/events200 OK (Event List)GET /v1/numbers200 OK (Account Registrations)

What's next?