If you have previously completed one or more US A2P 10DLC registrations for messaging to the United States, but you are not sure if all of your Twilio numbers or use cases are properly registered, you can verify this using the Twilio Console or APIs.
If you have a complex account structure or are an Independent Software Vendor (ISV), we strongly recommend you do these verification steps to make sure all of your traffic is properly registered.
Using the Twilio Console to verify your US A2P 10DLC registration status
From within the Twilio Console, check your Active Numbers page to see which of your Twilio numbers are associated with a Messaging Service. All of your United States and Canada long code numbers that are used for messaging to the US should be associated with a Messaging Service.
Then, within each of your Messaging Services, visit the "A2P & Compliance" tab to verify the Service has a registered campaign attached. A Messaging Service with a successfully registered Campaign will show green checkmarks next to each registration step and a Campaign Use Case status of "Verified."
If you have sent unregistered messages in the past 7 days, you will see an alert in the console that says you’re at risk of incurring penalty fees.
This alert includes a downloadable list of all the Phone Numbers that have sent unregistered traffic in the past 7 days from your account’s Twilio console. For more details on what this alert means and how to register these numbers, please see Why am I seeing an alert in the Twilio console that says I’m at risk of incurring penalty fees?
Using the API to verify your US A2P 10DLC registration status
Using the API, you can use the following steps to ensure that all of your Twilio phone numbers are registered.
- (Optional) If you have more than one Twilio account, fetch a list of all of your active accounts so that you can iterate over those in step 2 below.
- Fetch all of your Messaging Services under each of your accounts, and check that each has a US A2P Campaign. Any Messaging Service that contains US/Canada long code numbers for messaging to United States recipients should have one.
- For each Messaging Service with an A2P Campaign, build a list of "registered" numbers by fetching that Service’s Phone Numbers.
- Finally, compare this with your full list of Phone Numbers to find any Twilio numbers on your account that remain unregistered. Please note: Numbers that are not within the +1 country code, or that are Toll-Free (+1 8XX where XX is two repeating digits, e.g. +1 855) can be ignored.