• Home
  • Products
    • Lead Routing
    • Segmentation
    • List Matching
    • Fuzzy Matching
  • Solutions
    • Enterprise
      • Lead Routing
      • Segmentation
      • Editions
    • SMB
      • Salesforce Lead Routing
      • Free Lead to Account Matching Software
  • Resources
    • Videos
    • White Papers
    • Data Sheets
    • Competitive Analysis
    • Developer Portal
  • Company
    • About Us
    • Blog
    • News Releases
    • Careers at LeadAngel – Join Us
    • Partner
    • Contact Us
  • Documentation
Contact Sales Sign-In
  • Home
  • Products
    • Lead Routing
    • Segmentation
    • List Matching
    • Fuzzy Matching
  • Solutions
    • Enterprise
      • Lead Routing
      • Segmentation
      • Editions
    • SMB
      • Salesforce Lead Routing
      • Free Lead to Account Matching Software
  • Resources
    • Videos
    • White Papers
    • Data Sheets
    • Competitive Analysis
    • Developer Portal
  • Company
    • About Us
    • Blog
    • News Releases
    • Careers at LeadAngel – Join Us
    • Partner
    • Contact Us
  • Documentation
Contact Sales Sign-In
  • Home
  • Product
    • Lead Routing
    • Segmentation
    • List Matching
    • Fuzzy Matching
  • Solutions
    • Enterprise
      • Lead Routing
      • Segmentation
      • Editions
    • SMB
      • Salesforce Lead Routing
      • Free Lead to Account Matching Software
  • Resources
    • White Papers
    • Videos
    • Data Sheets
    • Competitive Analysis
  • Company
    • About Us
    • Blog
    • News Releases
    • Careers at LeadAngel – Join Us
    • Partner
    • Contact Us
  • Documentation
    • Getting Started
      • What is LeadAngel
      • LeadAngel Glossary
      • Icons Glossary
      • Setup Guide
        • SFDC App Setup
        • Upgrade to Enterprise Edition
        • Integrations
    • Product Docs
      • Routing Concepts
      • Segmentation Concepts
      • Sales Team
      • Data Dictionary
      • Routing Territory
      • Lead Segment
      • Lead Router
      • Reporting
      • Preferences
      • Tie Breaker
      • Auto Conversion
      • User Management
      • FuzzyMatch REST API
    • Frequently Asked Questions
    • Troubleshoot
ContactSign-In
  • Home
  • Product
    • Lead Routing
    • Segmentation
    • List Matching
    • Fuzzy Matching
  • Solutions
    • Enterprise
      • Lead Routing
      • Segmentation
      • Editions
    • SMB
      • Salesforce Lead Routing
      • Free Lead to Account Matching Software
  • Resources
    • White Papers
    • Videos
    • Data Sheets
    • Competitive Analysis
  • Company
    • About Us
    • Blog
    • News Releases
    • Careers at LeadAngel – Join Us
    • Partner
    • Contact Us
  • Documentation
    • Getting Started
      • What is LeadAngel
      • LeadAngel Glossary
      • Icons Glossary
      • Setup Guide
        • SFDC App Setup
        • Upgrade to Enterprise Edition
        • Integrations
    • Product Docs
      • Routing Concepts
      • Segmentation Concepts
      • Sales Team
      • Data Dictionary
      • Routing Territory
      • Lead Segment
      • Lead Router
      • Reporting
      • Preferences
      • Tie Breaker
      • Auto Conversion
      • User Management
      • FuzzyMatch REST API
    • Frequently Asked Questions
    • Troubleshoot

LeadAngel Company Name Match is implemented using REST API protocol. It takes a JASON document as input parameters, and returns the match result in JASON format. Along with the JASON document, the request URL also contains the Client ID and Client Key.

Staging URL is:

https://matchapi-stage.leadangel.com/usamasterdb/matchcompany?key=‘key’&clientID=‘clientID’

Please contact your account executive or success@leadangel.com to get your Client ID and Key.

Request Jason

Only the company is mandatory in the input parameter. Rest all can be blank.

matchesReturned can be blank, or any number between 1-3. In case of blank or numbers outside of 1-3, the API will return only the top match. If matchesReturned is set to 2 or 3, API will return up-to 2 or 3 top matches if found.

Providing email, website and address will help improve the accuracy.

Request
{
"lead_name" => "",
"company"=> "LeadAngel",
"email"=> "",
"website"=> "",
"zip"=> "",
"city"=> "",
"state"=> "",
"country"=> "",
"levenshteinMatching":"yes"
"matchesReturned"=> "3"
}

Response Jason

Response contains all the request parameters, followed by Match Status and the matched company details. Response contains a dynamic array of match results, containing up to 3 match results sorted by matchRank.

Response
{
"request":
{"lead_name":"",
"company":"",
"email":"",
"website":"",
"zip":"",
"city":"",
"state":"",
"country":"",
"levenshteinMatching":""
"matchesReturned":""},
"response":
[
	{
	"matchRank":"",
	"status":"",
	"matched_acount_name":"",
	"matched_acount_website":"",
	"matched_acount_zip":"",
	"matched_acount_city":"",
	"matched_acount_state":"",
	"matched_acount_country":"",
        "matched_acount_industry": "", 
        "matched_acount_sic_code": "", 
        "matched_acount_naics": "",
	"matchScore":""
	},
	{
	"matchRank":"",
	"status":"",
	"matched_acount_name":"",
	"matched_acount_website":"",
	"matched_acount_zip":"",
	"matched_acount_city":"",
	"matched_acount_state":"",
	"matched_acount_country":"",
        "matched_acount_industry": "",
        "matched_acount_sic_code": "",
        "matched_acount_naics": "",
	"matchScore":""
	}
]
}

PHP Code Sample

<?php
//echo date('Y-m-d H:i:s');
$startTS = round(microtime(true) * 1000);
$key = "KEY";
$clientID = "ClientID";
//API Url
$url =
'http://matchapi-stage.leadangel.com/usamasterdb/matchcompany?key
='.$key.'&clientID='.$clientID;
//Initiate cURL.
$ch = curl_init($url);
//The JSON data.
$jsonData = array(
"lead_name" => "John Smith",
"company"=> "LeadAngel",
"email"=> "",
"website"=> "",
"zip"=> "94085",
"city"=> "Sunnyvale",
"state"=> "California",
"country"=> "USA",
"levenshteinMatching"=>"no",
"matchesReturned"=>"2"
);
//Encode the array into JSON.
$jsonDataEncoded = json_encode($jsonData);
//Tell cURL that we want to send a POST request.
curl_setopt($ch, CURLOPT_POST, 1);
//Attach our encoded JSON string to the POST fields.
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonDataEncoded);
//Set the content type to application/json
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type:
application/json'));
//Execute the request
$result = curl_exec($ch);
$endTS = round(microtime(true) * 1000);
echo "<br><br> Response Time";
echo $endTS - $startTS;
?>

Error Codes

Error CodeDescription
200Success. Not returned to clients.
100Technical error reading configuration files. Contact LeadAngel Support.
101Technical error reading legal suffixes file. Contact LeadAngel Support.
102Technical error reading common words file. Contact LeadAngel Support.
103Technical error reading configuration for match server. Contact LeadAngel Support.
104Technical error connecting to match server. Contact LeadAngel Support.
105Technical error reading internal database server configuration. Contact LeadAngel Support.
106Technical error connecting to database server. Contact LeadAngel Support.
107Technical error loading the application server. Contact LeadAngel Support.
108Technical error loading creating match index. Contact LeadAngel Support.
109Technical error while initial match. Contact LeadAngel Support.
110Technical error while parsing website and email domain. Contact LeadAngel Support.
111Technical error while parsing incoming record details. Contact LeadAngel Support.
112Technical error in primary match request. Contact LeadAngel Support
113Technical error while processing primary match results. Contact LeadAngel Support
114Technical error in secondary match request. Contact LeadAngel Support
115Technical error while parsing match results. Contact LeadAngel Support.
116Technical error while preparing lead data and match results. Contact LeadAngel Support.
117Technical error while preparing response JASON. Contact LeadAngel Support.
118Technical error while pre-processing incoming match record. Contact LeadAngel Support.
    • Getting Started
      • What is LeadAngel
      • LeadAngel Glossary
      • Icons Glossary
      • Setup Guide
        • SFDC App Setup
        • Upgrade to Enterprise Edition
        • Integrations
        • Uninstallation
    • Product Docs
      • Routing Concepts
      • Segmentation Concepts
      • Sales Team
      • Weighted Sales Team
      • Data Dictionary
      • Routing Territory
      • Lead Segment
      • Lead Router
      • Reporting
      • Preferences
      • Tie Breaker
      • Auto Conversion
      • User Management
      • FuzzyMatch REST API
    • Frequently Asked Questions
    • Troubleshoot