top of page

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

bottom of page