Infutor API – Identity Scoring

Overview

InfutorData is a consumer data and insights company that specializes in helping marketers and the platforms they work with continuously maintain a real-time view of their consumers’ profiles and behaviors as they change over time. We power personalized interactions to engage consumers with the right message, at the right time.

InfutorData brings together proprietary identity graph data to provide marketers with comprehensive and actionable identity data for every consumer and household in the US, alongside the earliest indicators of their in-market shopping behavior.

Our solutions ensure marketers have the most complete picture of a consumer’s identity, attributes, permissions, and in-market behaviors—helping to remove the guesswork around who, what, and when to reach out.

Customers who engage with us experience:

• Lead generation program ROI improvement
• Better customer acquisition & retention outcomes
• Intelligence to inform cross-sell opportunities
• Improved reputation and financial risk management

Inputs

The Infutor API accepts the following inputs:

At a minimum, one of the following input combinations is required for processing:

• Phone1
• Phone2
• Email
• FName + LName
• FullName
• Address1 + Zip
• Address1 + City + State

Outputs

Please be aware that the API response will only include fields where data is available. If an attribute does not have a match or relevant value for a given request, it will be omitted from the response.

Also, the number of attributes returned may vary depending on the strength of the match:

• When the data match is strong (matchLevel 1–2), you can expect a more complete set of fields in the response.
• When the match is weak or partial (matchLevel 3–6), only a limited number of fields may be returned.

Because of this, the structure of the response may differ from one call to another. We recommend building your integration to handle flexible and dynamic responses where not all fields are guaranteed to be present.

Consumer Data

Identity Scoring

The ID Score is an overall score, with values in the range of 0–100 that can be used for making pass/fail decisions about whether or not a given identity was verified.

Testing

To ensure that all test data remains separate from Production data and is excluded from reporting and analysis, include the test parameter in every test API request.

Test Parameter

&test=1

Example Request

https://api.leadid.com/SingleQuery?lac={ACCOUNTCODE}&lak={AUDITKEY}&lpc={PROVIDERCODE}&data={DATA}&test=1

Example JSON Representation

{
  "endpoint": "https://api.leadid.com/SingleQuery",
  "parameters": {
    "lac": "{ACCOUNTCODE}",
    "lak": "{AUDITKEY}",
    "lpc": "{PROVIDERCODE}",
    "data": "{DATA}",
    "test": 1
  }
}

Important: The test parameter must be included exactly as &test=1. If it is omitted or formatted incorrectly, the submitted data will be written to Production tables.

Validation Process

1. Execute your API tests using &test=1.
2. Send the complete API request URL(s) used during testing to: customersupport@infutor.com
3. Wait for confirmation from the Support Team that testing has been validated.
4. Do not launch changes into Production until you have received confirmation.

Notes

• Test traffic is isolated from Production reporting and analytics.
• Production data contamination can occur if the test parameter is not included exactly as specified.
• Providing the full request string helps the Support Team verify that test records were correctly processed.

Appendix A: JSON API Example

Example Request

https://api.leadid.com/SingleQuery?lac={ACCOUNTCODE}&data=FullName=randomFullName&FName=FName&LName=LName&Address1=Address1&Address2=Address2&City=City&State=State&Zip=Zip&Phone=Phone&Phone2=Phone2&Email=Email

Example Response

{
  "audit": {
    "ConsumerData": {
      "persistentId": "8B7BE3E01CF0541463E4A93C44A26F45",
      "householdId": "1EC643B8EBAF9E04F1859358F94821E106EA2537E832E0C65818BF281A7CA17951F6708EF462A299BECFD2AC8FA7383C",
      "matchLevel": 1,
      "IDScores": {
        "raw_response": {
          "Detail": {
            "IDScores": {
              "ValidAddress": 100,
              "ValidPhone": 100,
              "ValidEmail": 100,
              "ValidName": 100,
              "Deceased": 100,
              "NameToPhone": 100,
              "NameToEmail": 10,
              "NameToAddress": 100,
              "AddressToPhone": 100,
              "AddressToEmail": 10,
              "PhoneToEmail": 10,
              "PhoneConfidenceScore": 85,
              "AddressConfidenceScore": 70,
              "ValidCount": 5,
              "LinkageCount": 4,
              "RiskFlagCount": 0,
              "ValidationSummary": "PASS",
              "LinkageSummary": "PASS",
              "RiskFlagSummary": "PASS",
              "IDVerifyScore": 95,
              "ValidZip": 100,
              "ZipToPhone": 100
            }
          }
        }
      }
    }
  }
}

Appendix B: API Response Codes

The following is a table of potential output response codes and messages. Returned in the top-level error object when the request cannot be processed.

Identity-Specific Error Codes

Returned in the audit.market.ConsumerData section when an IDCompletion / Attributes / ID Scoring level error occurs.

Support

Please reach out to Customer Support for questions or assistance.