• Getting Started
• Receiving a Mobile Originated (MO) Message
• Sending a Mobile Terminated (MT) Message
• Carrier Code Lookup
• Fetching MT Delivery Reports
• Custom Web Form
• CRM API Callback
• Managing Groups
• New API Guide >>

Carrier Code Lookup

There is a $0.005 charge to look up a mobile number's carrier code. View Appendix A for a list of all carrier codes.

URL

http://mosms.sumotext.com/secure/sumoLookup.aspx?

HTTP Method - GET

Request Parameters

Param	Description
mobile	Number to look up carrier for.
shortcode	Short code used.

Sample Request

http://mosms.sumotext.com/secure/sumoLookup.aspx?mobile=5015551234&shortcode=74700

Sample Response

ATTUS

Response Fields

The response data comes as a string.

{carrier_code}

Field	Description
carrier_code	Carrier code corresponding to the user's cellular carrier.

See appendix a for a list of carrier codes.

The first line of the response contains this string. You may ignore the lines that follow (they contain the html markup that would call this method from a browser).

Error Response

If there is an error, the response will be a string containing an error message.

{error_message}

Error Messages

Message	Description
IP NOT REGISTERED	IP address not registered.
ERROR CARRIER NOT FOUND FOR: {mobile}	The carrier information for this number could not be found.