Line Status is in Private Beta. To access request, submit the request form.
The Private Beta phase is a tightly controlled release. This release might experience service instability, API changes, or errors. Twilio doesn't recommend that mission-critical applications depend on the availability of the service. This data package queries data from the mobile network operators' Home Location Register (HLR) and returns it as-is. Twilio doesn't guarantee its accuracy.
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. |