Twilio’s Lookup Line Status is now available in Public Beta. The feature lets you check whether a mobile phone number is still active before you send SMS messages or launch marketing campaigns.
Available from July 14, 2026, Line Status checks a mobile number on the carrier network and reports whether it is active, reachable, unreachable, inactive, or unknown.
When you make a Lookup request, Twilio returns one of the following statuses:
- Active – The number exists and is active on the mobile network.
- Reachable – The phone is active and currently connected to the mobile network.
- Unreachable – The number is active, but the phone is switched off or temporarily out of network coverage.
- Inactive – The number is no longer assigned or is invalid.
- Unknown – Twilio could not determine the status because of network limitations or other temporary issues.
The feature can help you:
- Remove inactive numbers from your contact list.
- Reduce messages sent to unreachable or invalid numbers.
- Improve the quality of your contact database.
- Make campaigns more efficient by targeting valid numbers.
To use the feature, you need to call the Twilio Lookup API and include the Fields=line_status parameter in your request. Twilio will then return the mobile number’s status along with an error code.
More about SendGrid (now Twilio) features and integrations.
