CarrierFinder API Documentation
getcarrier_byphone
Overview
The purpose of this function is to return the current carrier of the telephone number provided.
If the number belongs to a wireless carrier, the mms address will also be provided.
Service Endpoint
The service endpoint is found at: http://api.carrierfinder.net/api.py
​
The following request will return the current carrier for the following phone number: 4255033644http://api.carrierfinder.net/api.py?function=getcarrier_byphone&phone=4255033644&userid=xxx&key=xxx
Parameters
Parameter
Description
key
API access key
You must have a CarrierFinder account in order to create this key.
userid
User ID which this key belongs to
phone
10-digit phone number to lookup
Response Data Elements
Parameter
Description
status
Returns one of the following values:
​
ok - found data to return
​
error - encountered an error
carriername
Name of current carrier
phone
Phone number specified
wireless
Y - carrier is wireless
​
N - carrier is not wireless
sms_address
sms address (if wireless carrier)
mms_address
mms_address (if wireless carrier)
apicarrierid
API carrierid