Developers

Msgme APIs

Messaging API

get_mo_message

URL:

http://api.msgme.com/v1/messaging/get_mo_message

METHOD:

Get

DESCRIPTION:

Returns the details of a Mobile Originated (MO) Message. These are messages sent from a mobile phone.

PARAMETERS:

Parameter	Description
token	The security token that was returned using authentication_api method.
moid	ID (or comma delimited list of IDs) of the MO Message(s) to fetch.

API REQUEST:

http://api.msgme.com/v1/messaging/get_mo_message?token=[Developer token]&moid=[MO Message ID]

API RESPONSE:

		<?xml version="1.0" encoding="UTF-8"?>
		<apiResponse status="[Status text]" statusCode="[Status code]" >
			<messages startAt="1" numOfRecords="3">
				<mo_message
					moid="[id for mobile originated message]" 
					message="[mobile originated message]" 
					dateReceived="[YYYYMMDD hh:mm:ss]" 
					msidn="[10 digit mobile number]"
					carrier="[mobile carrier]"
					shortcode="[short code]"  
					keywordId="[keyword id]" 
					keywordName="[keyword name]" 
					mtid="[id of mobile terminated message if an MT response occured]" 
					mtMessage="[messge sent to mobile if an MT response occured]" />
					... 
				</messages>
		</apiResponse>

EXAMPLE USAGE:

In this example we will fetch the mobile originated message with id = 1000. The MOID can be found by using other messaging API calls to query for messages.

REQUEST:

GET http://api.msgme.com/v1/messaging/get_mo_message?token=0e9ace1582fbb754dfe7f4e11f572bf5273f3c69&moid=1000

RESPONSE:

		<?xml version="1.0" encoding="UTF-8"?>
		<apiResponse status="success" statusCode="200" >
			<messages page="1" numberOfPages="1">
				<mo_message moid="1000"  
					message="sports" 
					dateReceived="20090601 12:22:38" 
					msidn="4159999999" 
					carrier="ATT"
					shortcode="64763"  
					keywordId="12345" 
					keywordName="sports" 
					mtid="1231" 
					mt_message="Redsox Win!" />
			</messages>
		</apiResponse>