To authenticate, you have to use the provided token. Find out more about tokens.

  1. Retrieve your token from Self Service Portal > Licenses.
    If you don't have one yet, go to Self Service Portal > Licenses, click Add a Token and enter the required details.
  2. Enter your token as the value for CLIENT_ID.

Build a web client that can be used to make HTTPS POST requests. Since web requests are text based, the client can be developed using any technology on any platform.

The URL for XML based HTTPS POST request can be submitted to:

  • Test: https://elstest.experianinteractive.com/els/action
  • Production: https://els.experianinteractive.com/els/action

Note that the production URL has to be used instead of the associated IP address when submitting transactions. Clients not using the above URL will be excluded from the Disaster Recovery process that safeguards in the event of Production System failure.

Use the PARTNER_ID and CLIENT_ID assigned to you at time of onboarding.

Sample XML request

<elsgenericmessage>
   <customer>
        <partner_id>xxx</partner_id>
        <client_id>xxx</client_id>
        <cust_ref_no>999</cust_ref_no>
   </customer>
   <lead_trans_details>
        <first_name>JANE</first_name>
        <last_name>DOE</last_name>
   </lead_trans_details>
   <lead_phone>
        <phone_type>Home</phone_type>
        <phone_number>1234567890</phone_number>
        <phone_extension></phone_extension>
        <phone_country_code>01</phone_country_code>
   </lead_phone>
   <lead_phone>
        <phone_type>Business</phone_type>
        <phone_number>9876543210</phone_number>
        <phone_extension>1234</phone_extension>
        <phone_country_code>02</phone_country_code>
   </lead_phone>
   <lead_address>
        <address_type>Home</address_type>
        <street1>1 MAIN ST</street1>
        <street2></street2>
        <city>HOPKINTON</city>
        <state>MA</state>
        <zip>01748</zip>
        <country>US</country>
   </lead_address>
</elsgenericmessage>

Test the web client by submitting a sample request.

Validate the response by checking for presence of standardized address information.

Sample XML response

<elsgenericmessage>
   <standardizedaddress>
        <full_address>1 MAIN ST</full_address>
        <street1>1 MAIN ST</street1>
        <street2></street2>
        <prim_range>38</prim_range>
        <sec_range></sec_range>
        <prim_name>MAIN</prim_name>
        <predir></predir>
        <city>HOPKINTON</city>
        <state>MA</state>
        <zip>01748</zip>
        <zipplus>2026</zipplus>
        <po_box_num></po_box_num>
        <rr_box_num></rr_box_num>
        <rr_num></rr_num>
        <postdir></postdir>
        <suffix>DR</suffix>
        <unit_desig></unit_desig>
        <carrier_route>R008</carrier_route>
        <geo_msa>14460</geo_msa>
        <geo_lng>-71.581243</geo_lng>
        <geo_lat>42.206978</geo_lat>
        <geo_blk>3201023013</geo_blk>
        <dpbc>03</dpbc>
        <checkdigit>7</checkdigit>
        <address_type>S</address_type>
        <county>MIDDLESEX</county>
        <county_code>017</county_code>
        <country>US</country>
        <fipscode>25017</fipscode>
        <address_code>1</address_code>
        <firmline></firmline>
        <geomatch>0</geomatch>
        <matchzipfive>T</matchzipfive>
        <matchzipnine>T</matchzipnine>
        <ziptype></ziptype>
        <suitablefordelivery>F</suitablefordelivery>
        <lacscode></lacscode>
   </standardizedaddress>
   <stage1data>
        <score_result>450</score_result>
        <score_desc>Phone Missing - Search information not received</score_desc>
        <elsresidentialaddressverificationresult>650</elsresidentialaddressverificationresult>
        <elsresidentialaddresshighrisk>N</elsresidentialaddresshighrisk>
        <elsresidentialphoneverificationresult>450</elsresidentialphoneverificationresult>
        <elsresidentialphonehighrisk>N</elsresidentialphonehighrisk>
        <elsresidentialphoneappend></elsresidentialphoneappend>
        <elsbusinessphoneappend></elsbusinessphoneappend>
   </stage1data>
   <message>
        <type>STATUS</type>
        <category></category>
        <value></value>
        <result_code>S100</result_code>
   </message>
   <transaction_id>13349938</transaction_id>
   <inputdata>
        <prefix>MS</prefix>
        <state>MA</state>
        <full_name></full_name>
        <phone_number></phone_number>
        <street1>1 MAIN ST</street1>
        <email>annother@yahoo.com</email>
        <outputtype>xml</outputtype>
        <client_id>xxx</client_id>
        <last_name>DOE</last_name>
        <middle_name></middle_name>
        <first_name>JANE</first_name>
        <city>HOPKINTON</city>
        <street2></street2>
        <zip>01748</zip>
        <suffix>JR</suffix>
   </inputdata>
</elsgenericmessage>

Sample Java Client Application

package com.experian.www.els.requestadapter.webservice.test;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
public class TestClientXMLPost {
/**
* @param args
* @throws IOException
*/
public static void main(String[] args)  {
   try {
        URL eiUrl = new URL("https://elstest.experianinteractive.com/els/action" );
        URLConnection ieConn = eiUrl.openConnection();
        HttpURLConnection connection = (HttpURLConnection) ieConn;
        connection.setDoOutput(true);
        connection.setDoInput(true);
        connection.setRequestProperty("Content-Type", "text/xml") ;
        connection.setRequestMethod("POST");
        PrintWriter wout = new PrintWriter(connection.getOutputStream());
        // Add the search fields to the query string
        String postStr = "  <partner_id>xxx <client_id>xxx <cust_ref_no>999 <lead_trans_details> <first_name>SHEILA <last_name>HANNON <lead_phone> <phone_type>Home <phone_number>1234567890 <phone_extension></phone_extension> <phone_country_code>01 <lead_phone> <phone_type>Business <phone_number>9876543210 <phone_extension>1234 <phone_country_code>02 <lead_address> <address_type>Home 7614 YORK AVE S APT 3211 MINNEAPOLIS MN 55435 US";
        wout.print(postStr);
        wout.flush();
        wout.close();
        BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
        StringBuilder strBuilder = new StringBuilder();
        char[] carr = new char[1024];
        int count = -1;
        while ((count=in.read(carr)) != -1) {
             strBuilder.append(carr, 0, count);
        }
        String eiResult = strBuilder.toString();
        System.out.println("eiResult="+eiResult);
        in.close();
        connection.disconnect();
       }catch (Exception e){
         e.printStackTrace();
       }
   }
}
Prospect IQ

Legacy integration options