National Format

Rate this page:

Twilio’s Lookup API returns phone numbers in national format, a string containing the phone number formatted according to the most common style in the associated country.

North American Numbers

For example, phone numbers in the United States are defined by the North American Numbering Plan (NANP) as ten-digit numbers consisting of:

  1. A three-digit Numbering Plan Area [local link] (NPA) code, commonly called an area code
  2. A seven-digit local number. The format is usually represented as NXX-NXX-XXXX where N is any digit from 2 through 9 and X is any digit from 0 through 9.

The national format returned by Twilio for NANP numbers is therefore (NXX) NXX-XXXX.

Rate this page:

Thank you for your feedback!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

Step 1

Get link

Get a free personal referral link here

Step 2

Give $10

Your user signs up and upgrade using link

Step 3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more