Getasms SMS API
History of SMS Sent

Description

Get a list of sending history

Method

Get

Call

Base URL
https://api.getasms.com/api/v1/history/list.xml
Name
Mandatory
Description
id_client
YES
This is a unique ID to identify the client
api_key
YES
This is a GUID to identify the client and for access to the API
type_to
NO
Type of send:
   0 address book list
   1 single number
number
NO
Phone number
date_send
NO
Date of send
 NumberOfRecords 
NO
By Default: 100 Items. If 0 return All. If PageNumber is used, it determines the page size (number of records per page)
PageNumber
NO
Indicates the requested page number. It’s necessary to use with the parameter NumberOfRecords
SortByName
NO
Default false (and then sort by Creation Date Desc)
statusCode
YES
   1 Queued
   2 Pending
   3 Sent
   4 Failed

Example of result 1:

								
<?xml version='1.0' encoding='UTF-8'?> 
<api version="1"> 
<histories> 
	<history> 
		<id_history>5025</id_history> 
		<date_send>12.12.2012</date_send> 
		<message>Hello world!</message>
		<charge>1205</charge> 
		<address_book_list> 
			<id_address_book>2506</id_address_book> 
				<phones> 
					<phone> 
						<id_number>1025</id_number> 
						<number>0041791234545</number> 
						<status>Jean</status> 
					</phone> 	 	 	 	 	 
				</phones> 
			<id_address_book>2507</id_address_book> 
		</address_book_list> 
	</history> 
</histories> 
</api>
								
								

Example of result 2:

								
<?xml version='1.0' encoding='UTF-8'?> 
<api version="1"> 
	<histories> 
		<history> 
			<id_history>5026</id_history> 
			<date_send>12.12.2012</date_send> 
			<message>Hello world!</message> 	 	 	 
			<charge>1205</charge> 
			<number>0041796543210</number> 
			<status>1</status> 
		</history> 
	</histories> 
</api> 
								
								

Result Attributes

Name
Description
histories[] Contains list of historics
    history[] Identify each historic
        id_history ID of the historic
        date_send Date SMS was sent
        message Message
        charge Required number of credit for this send
 

Send SMS around the world with GetaSMS™

Easy to use with the lowest costs on the market