Release Stage and Access
Lookup's Line Status is in Private Beta. To request access, submit this form. The Private Beta phase is a tightly controlled release. Participants should prepare for possible service instability, API changes, or defects. It is not recommended that mission-critical applications depend on the availability of the service. However, all data is queried from live and accurate sources. Information is returned as-is from mobile network operators' HLR and thus we do not provide any assurance on its accuracy.
Coverage and Limitations
It is generally supported worldwide, but may not return data from every network. Please conduct tests to confirm coverage for your desired country and network.
Lookup's Line Status package validates if the phone number is active, inactive, reachable, unreachable, or unknown on the carrier network in order to have accurate contact information and improve campaign efficiency.
To make a Line Status request, add line_status to the optional query parameter Fields when making a standard Lookup request.
1curl -X GET "https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}?Fields=line_status" \ -u2$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
The following additional properties are returned for a Line Status request.
| Property | Description |
|---|---|
Status | The status of the requested mobile phone number. See Status property values for more information. |
ErrorCode | The error code, if any, associated with your request. |
The following are the possible values for the Status property.
| Value | Description |
|---|---|
Active | Indicates that the number is valid and active (but not necessarily reachable) on the mobile network. |
Reachable | Indicates that the number is valid and the target handset is currently connected to the mobile network and reachable. |
Unreachable | Indicates that the number is valid and active on the mobile network, but the target handset is currently switched off or out of network reach. |
Inactive | Indicates that the number is not currently assigned to any subscriber on the mobile network or is invalid. |
Unknown | Indicates that the status could not be determined and the status is unknown. This can be caused by lack of connectivity to the target network operator or other exceptions and errors. |