Line Type Intelligence is in Public Beta. To access request, submit the request form.
The information in this document might change as we add or update features before the product becomes Generally Available. Public Beta products don't have a Service Level Agreement (SLA).
To validate a phone number's status on the carrier network, use Line Status. It detects whether a number is active, inactive, reachable, unreachable, or unknown. This information can help you improve your contact data quality and campaign efficiency.
Line Status supports phone numbers worldwide.
Note: Line Status might not return data for some networks. Make sure that you test the coverage for your desired country and network.
Make a GET /v2/PhoneNumbers/{PhoneNumber} request with the Fields=line_status query parameter.
1curl -X GET "https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}?Fields=line_status" \ -u2$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
A Line Status request returns the following properties.
| Property | Description |
|---|---|
Status | The status of the requested mobile phone number. |
ErrorCode | The error code, if any, associated with your request. |
The following are the possible values for the Status property.
| Value | Description |
|---|---|
Active | The number is valid and active (but not necessarily reachable) on the mobile network. |
Reachable | The number is valid and the target handset is connected to the mobile network and reachable. |
Unreachable | The number is valid and active on the mobile network, but the target handset is switched off or out of network reach. |
Inactive | The number isn't assigned to any subscriber on the mobile network or is invalid. |
Unknown | The status is unknown. This might occur due to a lack of connectivity with the target network operator or other exceptions and errors. |