Quick Start

The following instructions are intended for developers that want to pragmatically access Listrak account data and initiate various account commands from other systems. The concepts expressed throughout the documentation website assume users are familiar with using the Listrak Graphical User Interface (GUI).

Listrak highly recommends contacting Support at support@listrak.com or 717.627.4528 in order to ascertain what integration features and processes best match your needs.

For security reasons, access to any Listrak API is strictly controlled through the Master Administration Account. When using sub accounts within Listrak’s APIs, you will need to make sure your user has the APIs and access to the particular Web Method or XML call you are using through the API. For example, if a user, running through a particular API, does not have access to the Profiling System within the Listrak GUI, it will not have access to the related interfaces within the API. Additionally, all log-on lock-out routines and password complexity rules will be enforced across all external resources including the Listrak GUI, SOAP 1.1, SOAP 1.2, and XML over HTTP interfaces.

SOAP 1.1 and SOAP 1.2

The following service URL’s can be used by developers that want to access Listrak’s services via SOAP 1.1 and SOAP 1.2 interfaces.

Web Service Documentation:
http://webservices.listrak.com/SoapWSDL.aspx
SOAP 1.1 and SOAP 1.2 Interface:
https://webservices.listrak.com/v31/IntegrationService.asmx
Web Services Description Language (WSDL):
https://webservices.listrak.com/v31/IntegrationService.asmx?WSDL
Web Services Discovery Document (DISCO):
https://webservices.listrak.com/v31/IntegrationService.asmx?DISCO

XML over HTTP

In order to utilize the Listrak XML over HTTP Services you will need to know the interface URL, XML Request / Response Structures, and the location of Listrak’s XML Test Tool. We strongly suggest using the Test Tool to develop and test your XML before you embed it in your code. Following this process will significantly simplify and speed-up your integration initiatives.

Requests made to the Listrak XML over HTTP System should be made using the HTTP 1.0 or 1.1 Protocol’s POST method. Setting up a connection with Listrak using the HTTP Protocol should be a straight forward process given that most modern programming languages already have built-in support to facilitate this type of communication. When a connection is established with the XML over HTTP interface, client applications will need to use the HTTP Protocol’s POST method to send XML Request to Listrak. Each HTTP request made to this interface should contain a Content-Type HTTP Header denoted below.

Once the communication channel has been established, XML requests can then be sent to Listrak. The requests and corresponding response structures are detailed in the XML over HTTP section of this website.

XML Request / Response Structures:  http://webservices.listrak.com/Legacy.aspx
XML over HTTP Interface:  https://webservices.listrak.com/xml/default.asp
HTTP Content-Type Header:  Content-Type: text/xml; charset=utf-8