Numbers API V2 Overview

The V2 version of the Numbers API introduces the international standard E.164 number formatting for all phone numbers. This allows phone numbers to be formatted for all countries globally in a standardized way. An E.164-formatted phone number will have a country code followed by the phone number digits. All our E.164 numbers are prefixed by the + symbol.

In the V1 version of the Numbers API, North American phone numbers were formatted using 10-digit phone numbers as part of the North America Numbering Plan (NANP). These will now be formatted in E.164 and include the country code of 1. The 10-digit NANP phone number format is not supported in V2.

Example of a V1 phone number: 2505551234

V2 version of the phone number: +12505551234

For the full list of changes in V2, see below in the What’s Changed and What’s New sections.

What's Changed

• All phone numbers are in E164 format
  • This is true for requests, responses, callbacks, and reports
• GET /api/v1/addresses is now GET /api/v2/e911Addresses
• /api/v1/accounts/{accountId}/importTnOrders is moving to /api/v2/accounts/{accountId}/importTnOrders/messaging
  • /api/v1/accounts/{accountId}/externalTns is deprecated
• Usage of the ?areaCode= query parameter now requires countryCodeA3= to be included
• All previously deprecated v1 endpoints are no longer supported

What's New

• 60+ country support on a single API
• countryCodeA3 and phoneNumberType are first-class parameters
• New resource groups for country-specific compliance
• All new resource groups support JSON

For the full list please visit the Numbers V2 API spec