TextReports APIs
-
Count SMS Records Search Results
Description: Gets the total number of records for the given job using the search criteriaUsage:
GET api/Alerts/Reports/Text/Search/Count/{JobCode}/{SearchField}/{SearchCriteria}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for SearchField String FromUri The field to search for criteria in Value Description TimeStamp The date and time the message was sent EntityName The name of the recipient entity EntityGuid Guid that uniquely identifies the recipient SMSAddress The phone number the message was sent to SMSResult The result of the message send ReplyText The text of any reply sent in response to the message SearchCriteria String FromUri The value to search for in the given field Returns:
Returns the total number of records for the given job
Examples:
<!-- Intent: retrieve the count of records for the sms alerts sent for job 1541867 that contain an EntityName like "Lindab". GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/Search/Count/1541867/EntityName/Lindab --> <!-- No XML input is required --> <!-- example return value --> <int>1</int>
-
List SMS Records
Description: Returns a paged set of records for the given jobUsage:
GET api/Alerts/Reports/Text/{JobCode}/{RowIndex}/{PageSize}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for RowIndex Int32 FromUri the starting row index for the page to get records from. The first row starts with 0. PageSize Int32 FromUri the total number of records to return in a page Returns:
Array of SMSRecord objects
Examples:
<!-- Intent: retrieve the records for the sms alerts sent for job 1541867. This will retrieve the 1st page of 5 records. GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/1541867/0/5 --> <!-- No XML input is required --> <!-- example return value --> <ArrayOfSMSRecord xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SwiftReach.Swift911.Core.Reports.SMS"> <SMSRecord> <Address1>25 Raven Avenue</Address1> <City>Piscataway</City> <County>Middlesex</County> <CustomerCode>200201</CustomerCode> <EntityName>Robert Lindabury</EntityName> <JobCode>1541867</JobCode> <Language>English</Language> <Latitude>40.557746887207031</Latitude> <ListCode>668027</ListCode> <Longitude>-74.495903179049492</Longitude> <PostalCode>08854-3666</PostalCode> <ReplyText/> <SMSAddress>9087203553</SMSAddress> <SMSResult>0</SMSResult> <State>New Jersey</State> <TimeStamp>12/1/2012 10:54:51 PM</TimeStamp> </SMSRecord> </ArrayOfSMSRecord>
-
List SMS Records
Description: Returns a paged set of records for the given job sorted as specifiedUsage:
GET api/Alerts/Reports/Text/{JobCode}/{RowIndex}/{PageSize}/{SortField}/{SortDir}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for RowIndex Int32 FromUri the starting row index for the page to get records from. The first row starts with 0. PageSize Int32 FromUri the total number of records to return in a page SortField String FromUri The field to sort the results by Value Description TimeStamp The date and time the message was sent EntityName The name of the recipient entity EntityGuid Guid that uniquely identifies the recipient SMSAddress The phone number the message was sent to SMSResult The result of the message send ReplyText The text of any reply sent in response to the message SortDir String FromUri The direction to sort the results Value Description ASC Sort in ascending order DESC Sort in descending order Returns:
Array of SMSRecord objects
Examples:
<!-- Intent: retrieve the records for the sms alerts sent for job 1541867. This will retrieve the 1st page of 5 records sorted by TimeStamp in an Ascending direction. GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/1541867/0/5/TimeStamp/ASC --> <!-- No XML input is required --> <!-- example return value --> <ArrayOfSMSRecord xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SwiftReach.Swift911.Core.Reports.SMS"> <SMSRecord> <Address1>25 Raven Avenue</Address1> <City>Piscataway</City> <County>Middlesex</County> <CustomerCode>200201</CustomerCode> <EntityName>Robert Lindabury</EntityName> <JobCode>1541867</JobCode> <Language>English</Language> <Latitude>40.557746887207031</Latitude> <ListCode>668027</ListCode> <Longitude>-74.495903179049492</Longitude> <PostalCode>08854-3666</PostalCode> <ReplyText/> <SMSAddress>9087203553</SMSAddress> <SMSResult>0</SMSResult> <State>New Jersey</State> <TimeStamp>12/1/2012 10:54:51 PM</TimeStamp> </SMSRecord> </ArrayOfSMSRecord>
-
Search SMS Records
Description: Returns a paged set of records for the given job sorted as specified and filtered by the search criteriaUsage:
GET api/Alerts/Reports/Text/Search/{JobCode}/{RowIndex}/{PageSize}/{SortField}/{SortDir}/{SearchField}/{SearchCriteria}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for RowIndex Int32 FromUri the starting row index for the page to get records from. The first row starts with 0. PageSize Int32 FromUri the total number of records to return in a page SortField String FromUri The field to sort the results by Value Description TimeStamp The date and time the message was sent EntityName The name of the recipient entity EntityGuid Guid that uniquely identifies the recipient SMSAddress The phone number the message was sent to SMSResult The result of the message send ReplyText The text of any reply sent in response to the message SortDir String FromUri The direction to sort the results Value Description ASC Sort in ascending order DESC Sort in descending order SearchField String FromUri The field to search for criteria in Value Description EntityName The name of the recipient entity EntityGuid Guid that uniquely identifies the recipient SMSAddress The phone number the message was sent to SMSResult The result of the message send ReplyText The text of any reply sent in response to the message SearchCriteria String FromUri The value to search for in the given field Returns:
Array of SMSRecord objects
Examples:
<!-- Intent: search the records for the sms alerts sent for job 1541867 to any EntityName that contains the text "Lindab". This will retrieve the 1st page of 5 records sorted by TimeStamp in an Ascending direction. GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/Search/1541867/0/5/TimeStamp/ASC/EntityName/Lindab --> <!-- No XML input is required --> <!-- example return value --> <ArrayOfSMSRecord xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SwiftReach.Swift911.Core.Reports.SMS"> <SMSRecord> <Address1>25 Raven Avenue</Address1> <City>Piscataway</City> <County>Middlesex</County> <CustomerCode>200201</CustomerCode> <EntityName>Robert Lindabury</EntityName> <JobCode>1541867</JobCode> <Language>English</Language> <Latitude>40.557746887207031</Latitude> <ListCode>668027</ListCode> <Longitude>-74.495903179049492</Longitude> <PostalCode>08854-3666</PostalCode> <ReplyText/> <SMSAddress>9087203553</SMSAddress> <SMSResult>0</SMSResult> <State>New Jersey</State> <TimeStamp>12/1/2012 10:54:51 PM</TimeStamp> </SMSRecord> </ArrayOfSMSRecord>
-
Count SMS Records
Description: Gets the total number of records for the given jobUsage:
GET api/Alerts/Reports/Text/Count/{JobCode}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for Returns:
Returns the total number of records for the given job
Examples:
<!-- Intent: retrieve the count of records for the sms alerts sent for job 1541867. GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/Count/1541867 --> <!-- No XML input is required --> <!-- example return value --> <int>1</int>
-
Download SMS Records
Description: Downloads a zipped comma-delimited CSV file of the raw recordsUsage:
GET api/Alerts/Reports/Text/Download/{JobCode}
Parameter Type Source Description JobCode Int32 FromUri the unique numerical code identifying the job to get records for Returns:
Zipped File Content
Examples:
<!-- Intent: Initiates a downbload of the raw records for the sms alerts sent for job 1541867. The records are returned in a zip compressed CSV file. GET to the following url http://api.v4.swiftreach.com/api/Alerts/Reports/Text/Download/1541867 --> <!-- No XML input is required --> <!-- example return value --> <!-- return value is a binary file -->