Line Status

(information)

Info

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.

Lookup Line Status is $0.007 per request.

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" \ -u
2$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Response properties

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.

Status property values

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.