Skip to content
Wire2AirWire2Air

Carrier lookup

Legacy

Find out whether a phone number belongs to a wireless carrier, a probable landline or no valid number, with the legacy HTTP API.

Last updated

GEThttp://carrierlookup.wire2air.com/carrierlookup/default.aspx
Credential
App key, sent as the APPKEY request parameter
Response
Plain text
Transport
Plain HTTP (not encrypted). See the warning on this page.

A lookup costs one third of a text credit.

Parameters

Send them in the query string (GET is the only documented method).

Parameters
ParameterDescription
APPKEY
stringrequired
in query
Your app key, from Manage Account → API Information in the dashboard. See authentication.
MOBILE
stringrequired
in query
The number to look up.
Example: 12121234567

Examples

curl -G "http://carrierlookup.wire2air.com/carrierlookup/default.aspx" \
  --data-urlencode "APPKEY=YOUR_APPKEY" \
  --data-urlencode "MOBILE=12121234567"

Response

The response is a number:

ResponseMeaning
greater than 1A valid wireless number. The value identifies the carrier.
-1Possibly a landline.
-2Not a valid number.
-3Authentication failed.
-500System error; report it to support.