Skip to contentSkip to navigationSkip to topbar
On this page

Line Status


(information)

Info

Release Stage and Access

Lookup's Line Status is in Private Beta. To request access, submit this form(link takes you to an external page). 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.

1
curl -X GET "https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}?Fields=line_status" \ -u
2
$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Response properties

response-properties page anchor

The following additional properties are returned for a Line Status request.

PropertyDescription
StatusThe status of the requested mobile phone number. See Status property values for more information.
ErrorCodeThe error code, if any, associated with your request.

Status property values

status-property-values page anchor

The following are the possible values for the Status property.

ValueDescription
ActiveIndicates that the number is valid and active (but not necessarily reachable) on the mobile network.
ReachableIndicates that the number is valid and the target handset is currently connected to the mobile network and reachable.
UnreachableIndicates that the number is valid and active on the mobile network, but the target handset is currently switched off or out of network reach.
InactiveIndicates that the number is not currently assigned to any subscriber on the mobile network or is invalid.
UnknownIndicates 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.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.