Release Stage and Access
Lookup's Line Status is in Pilot. To request access, submit this form. The Pilot 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 allows you to get the status information of a mobile phone number.
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. |