Experian Business Search API

Description

This API is used to find business information. This search presents a list of searching businesses that are ranked by match reliability code. Each business returned in the list includes the legal name, address, and phone number of the business Experian, and optionally business geocode data (geographic data on the location).

Definition

POST /services/apexrest/intframework/v2/invokeIntegrationService

Authentication Type

Basic Salesforce Auth 2.0

See this link for SFDC Documentation: https://help.salesforce.com/articleView?id=remoteaccess_oauth_web_server_flow.htm&type=5

Parameters

Header Parameters

The following table provides the details of the header parameters used by this web service:

Key	Value
Content-Type	application/JSON
charset	UTF-8
Accept	application/JSON

Body Parameters

The following table provides the details of the body parameters used by this web service:

Field Name	Type
integrationFamily	String
apiType	String
executionPriority	String
idsForFiltersMap	String
accountId	String
optionalRequestParamsMap	String

Error Messages

When you use this web service you can receive the possible error messages as shown in the following table:

Status Code	Error Message
400	Bad Request
401	Authorization information is missing or invalid
404	Not Found
500	Subscription Error
502	Server Error

Business Search API Code

{ 

"integrationFamily" :"Business Search",

"apiType" :"Business Search",

"executionPriority" :"1",

"idsForFiltersMap": {

        "accountId" :"{{BusinessAccount_Id}}"         },

"optionalRequestParamsMap": {}
 }

Sample Request

The sample request that you receive is as shown in the following block:

Sample Request Example

{
  "name": "Experian",
  "city": "Costa Mesa",
  "state": "CA",
  "subcode": "0586548",
  "street": "475 ANTON BLVD",
  "zip": "92626",
  "phone": "9495673800",
  "taxId": "176970333",
  "geo": true,
  "comments": "testing"}

Sample Response

The sample response that you receive is as shown in the following block:

Sample Response Example

{ "requestId": "ec55cca0-9342-11e7-bddf-ebd4476c3102", "responseMessage": "Your search did not match any records. Suggestions try adding optional fields like street address and phone to your search, check your spelling, and remember, the absence of a match can be valuable information.", "comments": "my_guid_for_tracking", "success": true, "results": [ { "bin": "800914632", "reliabilityCode": 91.02, "businessName": "EXPERIAN", "phone": "+17148307000", "address": { "street": "535 ANTON BLVD", "city": "Costa Mesa", "state": "CA", "zip": "92626", "zipExtension": "9262" }, "numberOfTradelines": 62, "financialStatementIndicator": true, "keyFactsIndicator": true, "inquiryIndicator": true, "bankDataIndicator": true, "governmentDataIndicator": true, "executiveSummaryIndicator": true, "uccIndicator": true, "matchingNameAndAddress": { "businessName": "EXPERIAN", "address": { "street": "535 ANTON BLVD", "city": "Costa Mesa", "state": "CA", "zip": "92626", "zipExtension": "9262" } }, "businessGeocode": { "latitudeLongitudeLevel": "Roof Top Level", "latitude": 33.690764, "longitude": -117.873551, "msaCode": "5945", "censusBlkGrpCode": "2", "censusTractCode": "063907", "cottageIndicator": true, "congressionalDistrictCode": "48", "dateLastReported": "01/01/1977" } } ] }

Usage/ How to Invoke

Usage/How to Invoke

sforce.apex.execute('intframework.IntegrationWebServiceV2', 'runSynchronousIntegrationService', { requestParameters: JSON.stringify(requestParam) });