Fraud Intelligence - KYC Fraud Signals (US)

Key Features

  • Enhanced US Coverage
    In the US, we provide an additional enhanced signals for KYC fraud detection using the same input tokens as Trulioo Person Fraud — no extra integration work is required.
  • Carrier Change History
    Phone porting, transfer, suspension, deactivation and migration events associated with the individual over 6-month, 12-month and 2-year windows.
  • Address Migration Velocity
    Consortium velocity attributes showing how often the input address and address + last name combination have been seen across account-open, address-change and address-discrepancy networks.
  • Account Inquiry Timing
    Days since an identity element was last seen, and the dates it was seen, to surface bursts of recent application activity.
  • Tiered Reason Codes
    Primary, secondary and tertiary reason codes accompany every score to support explainability and compliance justification.

Request Parameters

KYC Fraud Signals (US) is returned through the Trulioo Person Fraud datasource under Person Verification. Names and either a phone number or email are required; all other fields are optional, but every field helps improve predictiveness.

Example Request

{
  "VerificationType": "Demo",
  "PackageId": "f84f09f0-213a-4499-8370-29f371edddd",
  "CleansedAddress": false,
  "CountryCode": "US",
  "DataFields": {
    "PersonInfo": {
      "FirstGivenName": "Andrew",
      "FirstSurName": "Smith",
      "YearOfBirth": "1990"
    },
    "Location": {
      "AdditionalFields": {
        "Address1": "123 Main"
      }
    },
    "Communication": {
      "Telephone": "+9999999982",
      "EmailAddress": "[email protected]"
    },
    "CountrySpecific": {
      "US": {
        "IPAddress": "0.0.0.0"
      }
    }
  },
  "VerboseMode": true
}

Example Response

{
  "TransactionID": "3b73f7b1-16fc-4c7f-b22c-49e52a009e34",
  "UploadedDt": "2026-09-25T20:17:05.166000",
  "CompletedDt": "2026-09-25T20:17:08.210000",
  "CountryCode": "US",
  "ProductName": "Identity Verification",
  "Record": {
    "TransactionRecordID": "203a63b5-6d9f-5f2b-d5a5-730f954593d6",
    "RecordStatus": "nomatch",
    "DatasourceResults": [
      {
        "DatasourceName": "Trulioo Person Fraud",
        "DatasourceFields": [],
        "AppendedFields": [
          {
            "FieldName": "ScoreRiskSignals",
            "Data": {
              "ReasonCodes": {
                "PrimaryReasonCode": "EnformionPhoneRanking",
                "SecondaryReasonCode": "verification_phonematch",
                "TertiaryReasonCode": "CountOfPhoneOperatorsOverPast5Years"
              },
              "RiskLevel": "High",
              "Score": 725
            }
          },
          {
            "FieldName": "PhoneRiskSignals",
            "Data": {
              "PhoneToName": "No Match",
              "PhoneFirstSeen": "2026-08-27",
              "PhoneInfo": {
                "PhoneValid": true,
                "LastPortDate": "2015-11-06",
                "IsBusiness": true,
                "PhoneCountryCode": "US"
              }
            }
          },
          {
            "FieldName": "EmailRiskSignals",
            "Data": {
              "EmailFirstSeen": "2026-03-04",
              "EmailToName": "No Match",
              "EmailInfo": {
                "EmailValid": "valid",
                "EmailIsDisposable": false,
                "EmailDomainCreationDate": "2025-10-29",
                "EmailDomainRegisteredTo": null
              }
            }
          },
          {
            "FieldName": "RiskSignals",
            "Data": {
              "isDeceased": false,
              "estimatedIncome": 0,
              "addressinfo_criminalindex": 0,
              "demographicstatistics_creditactive": 0,
              "demographicstatistics_homeowner": 0,
              "fin_address": 0,
              "fin_phone": 0,
              "velocity_accountopen_address_dayssincelastseen": 0,
              "velocity_accountopen_addresslastname_ssncount": 0,
              "velocity_accountopen_addresslastname_timesseen": 0,
              "velocity_addrdiscrepancy_address_abacount": 0,
              "velocity_addrdiscrepancy_address_lastcount": 0,
              "velocity_addrdiscrepancy_address_ssncount": 0,
              "velocity_addrdiscrepancy_address_timesseen": 0,
              "velocity_addrdiscrepancy_addresslastname_dayssincelastseen": 0,
              "velocity_addrdiscrepancy_addresslastname_hphonecount": 0,
              "velocity_profilechange_address_dayssincelastseen": 0,
              "velocity_profilechange_address_hphonecount": 0,
              "velocity_profilechange_addresslastname_hphonecount": 0,
              "velocity_profilechange_addresslastname_nincount": 0,
              "velocity_profilechange_addresslastname_timesseen": 0,
              "velocity_profilechange_fromaddress_dayssincelastseen": 0,
              "velocity_profilechange_fromaddress_lastcount": 0,
              "velocity_profilechange_fromaddress_nincount": 0,
              "personNumSuspend12months": 1,
              "personNumTransfer12months": 2,
              "personNumDeact2years": 5,
              "numdisc2yearperson": 0,
              "personnumdeletes6months": 0,
              "personnumupdates12months": 1,
              "personnumports12months": 1,
              "personNumDeact12months": 3,
              "personnumupdates6months": 0,
              "age": 30,
              "personNumSuspend2years": 2,
              "personnumupdates2years": 2,
              "personnumports6months": 0,
              "personnumports2years": 2,
              "numdiscperson": 0,
              "personnummigrates2years": 0,
              "personnummigrates12months": 0,
              "avgPhoneTenure": 1348,
              "personnummigrates6months": 0,
              "personNumTransferNewAC": 5,
              "numLocations": 21,
              "personnumdeletes2years": 0,
              "personNumTransfer2years": 2,
              "personnumdeletes12months": 0,
              "hasVehicleRegistrationsRecords": false,
              "hasLienRecords": false,
              "hasDivorceRecords": false,
              "hasProfessionalLicenseRecords": false,
              "hasBusinessRecords": false,
              "hasEvictionsRecords": false,
              "hasForeclosuresRecords": false,
              "hasmobilephones": false,
              "hasDebtRecords": true,
              "hasJudgmentRecords": true,
              "hasPropertyV2Records": true,
              "hasaddresses": false,
              "hasBankruptcyRecords": false,
              "haslandlines": false,
              "hasMarriageRecords": false,
              "addressInfo": {
                 "landuse": null,
                 "addressVerified": "true",
                 "returnCode": "01",
                 "dwellType": "S",
                 "addressIndicator": "R",
                 "criminalIndex": 55,
                 "unitNumberMissing": false,
                 "mailable": true
              },
              "phoneInfo": [
                {
                  "type": "home",
                  "portingStatus": "YES",
                  "spid": "979E",
                  "carrierName": "BANDWIDTH.COM CLEC, LLC",
                  "portingDate": "2015-11-06T22:00:00",
                  "prepaid": false,
                  "lat": 42.9233,
                  "lon": -83.6348,
                  "areaCodeRiskIndex": 28,
                  "popDensity": 668.5,
                  "resBiz": "CONSUMER",
                  "carrierCategory": "VOIP",
                  "distance": {
                    "toAddressToPhone": 0
                  }
                }
              ],
              "phoneDetails": [
                {
                  "landline": true,
                  "voip": false,
                  "wireless": false,
                  "phoneorder": 12,
                  "numoperators": 10,
                  "numvendors": null,
                  "numoperators5year": 9,
                  "dayssincemaxmaxrecdate": 938,
                  "dayssincemaxmaxrcvdate": 937,
                  "dayssinceminminrecdate": 967,
                  "dayssinceminminrcvdate": 967,
                  "dayssinceminmaxrecdate": 938,
                  "dayssinceminmaxrcvdate": 937,
                  "dayssincemaxminrecdate": 967,
                  "dayssincemaxminrcvdate": 967
                }
              ],
              "emailInfo": {
                "emailValid": true,
                "emailDisposable": false,
                "emailSMTP": "2",
                "emailValidity": "3",
                "emailGeneric": false,
                "emailCommon": false,
                "emailDNSValid": true,
                "emailHoneypot": false,
                "emailDeliverability": "High",
                "emailUnsubscribe": false,
                "emailCatchAll": true,
                "emailServerError": true,
                "emailRecentAbuse": false,
                "emailSuggestedDomain": "N/A",
                "emailLeaked": false,
                "emailDomainAge": "10/29/2025 5:48:21 AM",
                "emailFirstSeen": "3/4/2026 1:43:44 PM",
                "emailDomainTrust": "Not Rated",
                "emailDomainPopularity": "None",
                "emailUserActivity": null,
                "emailDomainInfo": [
                  {
                    "ipAddress": "172.253.135.26",
                    "isp": "Google Servers",
                    "org": "Google Servers",
                    "anonymousProxy": false
                  }
                ]
              },
              "emailDetails": null,
              "message": [
                {
                  "code": "AP015",
                  "description": "No Name or Address reported with Phone"
                },
                {
                  "code": "AE021",
                  "description": "Email First Seen in the Past 181-365 Days"
                },
                {
                  "code": "AE025",
                  "description": "Email Encountered in the Past Year"
                },
                {
                  "code": "AE027",
                  "description": "No Activity at Email in the Past 6 Months"
                },
                {
                  "code": "AE031",
                  "description": "Email Seen at Zero Sources"
                },
                {
                  "code": "AP046",
                  "description": "Input Phone Number is a VOIP Line"
                }
              ],
              "velocityAttributes": [
                {
                  "category": "KDN",
                  "element": "HPHONE",
                  "timesSeen": 21,
                  "datesSeen": {
                    "date": [
                      "9/25/2026 1:17:06 PM",
                      "9/16/2026 10:21:13 AM",
                      "9/16/2026 10:18:51 AM",
                      "9/16/2026 10:02:55 AM",
                      "9/16/2026 9:33:38 AM",
                      "9/16/2026 9:33:07 AM",
                      "9/14/2026 4:06:15 PM",
                      "7/20/2026 11:44:01 AM",
                      "7/20/2026 10:57:21 AM",
                      "7/20/2026 8:53:20 AM"
                    ]
                  },
                  "daysSinceLastSeen": 9,
                  "lastNameCount": 3,
                  "ABACount": 1,
                  "addressCount": 0,
                  "HPhoneCount": 1,
                  "BPhoneCount": null,
                  "DOBCount": null,
                  "emailCount": 2,
                  "IPCount": 1,
                  "NINCount": 0,
                  "AccountIDCount": null
                }
              ],
              "verificationResult": {
                "matchScore": 36.99,
                "firstName": {
                  "matchTypeCode": "NO_MATCH"
                },
                "middleName": {
                  "matchTypeCode": "NA"
                },
                "lastName": {
                  "matchTypeCode": "NO_MATCH"
                },
                "ssn": {
                  "matchTypeCode": "NA"
                },
                "dobDay": {
                  "matchTypeCode": "NA"
                },
                "dobMonth": {
                  "matchTypeCode": "NA"
                },
                "dobYear": {
                  "matchTypeCode": "NA"
                },
                "address": {
                  "matchTypeCode": "NA"
                },
                "city": {
                  "matchTypeCode": "NA"
                },
                "state": {
                  "matchTypeCode": "NA"
                },
                "postalCode": {
                  "matchTypeCode": "NA"
                },
                "email": {
                  "matchTypeCode": "NO_MATCH"
                },
                "phone": {
                  "matchTypeCode": "MATCH"
                }
              }
            }
          }
        ],
        "Errors": [],
        "FieldGroups": []
      }
    ],
    "Errors": [],
    "Rule": {
      "RuleName": "Category 3 KYC v3",
      "Note": "Match(FamilyAndGivenInitial, DOB) or Match(FamilyAndGivenInitial, FullAddress) or Match(FamilyAndGivenInitial, ID) MiddleName Ignored"
    },
    "SupplementaryRules": []
  },
  "Errors": []
}

Request and Response Structure

Upon submitting a request, the API returns a response containing several key elements. These elements provide insight into the potential risks associated with the submitted data.

📘

Score: A risk score, including tiered reason codes and the overall risk level.

Output

All fraud signals are returned under AppendedFields and are grouped into four objects: ScoreRiskSignals, PhoneRiskSignals, EmailRiskSignals and RiskSignals. Each object's content is returned in its Data property.

Score (ScoreRiskSignals)

FieldDescriptionField TypeField ValuesNotes
ScoreRisk ScoreInteger0-1000Higher scores indicate higher risk of potential fraud.
RiskLevelRisk category based on the Risk ScoreString-Very Low
-Low
-Medium
-High
-Very High
Very Low: 0 to 225
Low: 226 to 450
Medium: 451 to 550
High: 551 to 775
Very High: 776 to 1000
ReasonCodes.PrimaryReasonCodeThe signal that contributed most to the scoreStringString
ReasonCodes.SecondaryReasonCodeThe signal that contributed second most to the scoreStringString
ReasonCodes.TertiaryReasonCodeThe signal that contributed third most to the scoreStringString

Phone (PhoneRiskSignals)

FieldDescriptionField TypeField ValuesNotes
PhoneToNameThe match status between the input name and the phone number providedString-Match
-No Match
-Not Found
-Null
PhoneFirstSeenThe date when the input phone number was first observed and associated with the input nameDateYYYY-MM-DD
PhoneInfo.PhoneValidIndicates whether the phone provided is validBoolean-True
-False
-Null
PhoneInfo.LastPortDateIndicates the date of the last portability event of the input phone numberDate-Date
-Null
Very recent port dates are higher risk.
PhoneInfo.IsBusinessIndicates whether the caller type of the input phone number is businessBoolean-True
-False
-Null
PhoneInfo.PhoneCountryCodeCountry associated with the input phone numberStringISO 3166-1 alpha-2

Email (EmailRiskSignals)

FieldDescriptionField TypeField ValuesNotes
EmailToNameThe match status between the input name and the email addressString-Match
-No Match
-Not Found
EmailFirstSeenThe date when the input email address was first observedDateYYYY-MM-DDIf the input email has not been observed before, the date will be today.
EmailInfo.EmailValidIndicates whether the email address provided is a valid and functional emailString-valid
-invalid
-unknown
-null
EmailInfo.EmailIsDisposableIndicates whether the email address belongs to a temporary email service providerBoolean-true
-false
-null
EmailInfo.EmailDomainCreationDateThe date when the email domain was createdDate-Date
-null
Format: YYYY-MM-DD
EmailInfo.EmailDomainRegisteredToThe individual or entity registered to the email domainString-String
-null
Typically useful for non-free email domains.

Risk Signals (RiskSignals)

RiskSignals contains the US-specific enhanced signals. Nested objects are described in the sections below.

Person & Public Records
FieldDescriptionField Type
isDeceasedFlag indicating if the person is deceasedBoolean
ageAge of the personInteger
numLocationsNumber of distinct locations in the Tahoe 'locations' fieldInteger
hasaddressesIndicates whether addresses are associated with this individualBoolean
haslandlinesIndicates whether landline phones are associated with this individualBoolean
hasmobilephonesIndicates whether mobile phones are associated with this individualBoolean
hasBankruptcyRecordsIndicates whether bankruptcy records are associated with this individualBoolean
hasBusinessRecordsIndicates whether business records are associated with this individualBoolean
hasDebtRecordsIndicates whether debt records are associated with this individualBoolean
hasDivorceRecordsIndicates whether divorce records are associated with this individualBoolean
hasEvictionsRecordsIndicates whether eviction records are associated with this individualBoolean
hasForeclosuresRecordsIndicates whether foreclosure records are associated with this individualBoolean
hasJudgmentRecordsIndicates whether judgment records are associated with this individualBoolean
hasLienRecordsIndicates whether lien records are associated with this individualBoolean
hasMarriageRecordsIndicates whether marriage records are associated with this individualBoolean
hasProfessionalLicenseRecordsIndicates whether professional license records are associated with this individualBoolean
hasPropertyV2RecordsIndicates whether property records are associated with this individualBoolean
hasVehicleRegistrationsRecordsIndicates whether vehicle registration records are associated with this individualBoolean
Person Activity History
FieldDescriptionField Type
avgPhoneTenureAverage tenure across all phone numbers associated with this individualInteger
numdisc2yearNumber of disconnect events in last 2 years (landline)Integer
numdisc2yearpersonNumber of disconnect events associated with a given person in last 2 yearsInteger
numdiscpersonNumber of disconnect events associated with a given person in totalInteger
personnumports6monthsNumber of port events associated with a given person in last 6 monthsInteger
personnumports12monthsNumber of port events associated with a given person in last 12 monthsInteger
personnumports2yearsNumber of port events associated with a given person in last 2 yearsInteger
personnumupdates6monthsNumber of update events associated with a given person in last 6 monthsInteger
personnumupdates12monthsNumber of update events associated with a given person in last 12 monthsInteger
personnumupdates2yearsNumber of update events associated with a given person in last 2 yearsInteger
personnummigrates6monthsNumber of migration events associated with a given person in last 6 monthsInteger
personnummigrates12monthsNumber of migration events associated with a given person in last 12 monthsInteger
personnummigrates2yearsNumber of migration events associated with a given person in last 2 yearsInteger
personnumdeletes6monthsNumber of deletion events associated with a given person in last 6 monthsInteger
personnumdeletes12monthsNumber of deletion events associated with a given person in last 12 monthsInteger
personnumdeletes2yearsNumber of deletion events associated with a given person in last 2 yearsInteger
personNumSuspend12monthsNumber of suspension events associated with a given person in last 12 monthsInteger
personNumSuspend2yearsNumber of suspension events associated with a given person in last 2 yearsInteger
personNumDeact12monthsNumber of deactivation events associated with a given person in last 12 monthsInteger
personNumDeact2yearsNumber of deactivation events associated with a given person in last 2 yearsInteger
personNumTransfer12monthsNumber of transfer events associated with a given person in last 12 monthsInteger
personNumTransfer2yearsNumber of transfer events associated with a given person in last 2 yearsInteger
personNumTransferNewACNumber of transfer events associated with a given person in last 2 years where the new number included a different area codeInteger
Suspected Fraud Lists
FieldDescriptionField Type
fin_addressAddress Matched to Suspected Fraud listInteger (0 or 1)
fin_phonePhone Matched to Suspected Fraud listInteger (0 or 1)
Area Demographics
FieldDescriptionField Type
estimatedIncomeThe estimated income at the original addressFloat
demographicstatistics_creditactiveThe estimated credit activity at the original addressFloat
demographicstatistics_homeownerThe estimated level of homeownership at the original addressFloat
demographicstatistics_lenofresidenceEstimated length of time the individuals in the area have resided at their current addressesFloat
addressinfo_criminalindexIndex value indicating criminal activity associated with the area of the input addressInteger
Velocity Network
FieldDescriptionField Type
velocity_accountopen_addresslastname_dayssincelastseenThe number of days since the address+last name combo was last seen within the Account Open velocity networkInteger
velocity_accountopen_addresslastname_ssncountThe number of SSNs seen with the input address+last name combo within the Account Open velocity networkInteger
velocity_accountopen_addresslastname_timesseenThe number of times the address+last name combo has been seen within the Account Open velocity networkInteger
velocity_addrdiscrepancy_address_abacountThe number of ABAs seen with the input address within the Address Discrepancy velocity networkInteger
velocity_addrdiscrepancy_address_lastcountThe number of last names seen with the input address within the Address Discrepancy velocity networkInteger
velocity_addrdiscrepancy_address_ssncountThe number of SSNs seen with the input address within the Address Discrepancy velocity networkInteger
velocity_addrdiscrepancy_address_timesseenThe number of times the address has been seen within the Address Discrepancy velocity networkInteger
velocity_addrdiscrepancy_addresslastname_dayssincelastseenThe number of days since the address+last name combo was last seen within the Address Discrepancy velocity networkInteger
velocity_addrdiscrepancy_addresslastname_hphonecountThe number of hphones seen with the input address+last name combo within the Address Discrepancy velocity networkInteger
velocity_profilechange_address_dayssincelastseenThe number of days since the address was last seen within the Address Change velocity networkInteger
velocity_profilechange_address_hphonecountThe number of hphones seen with the input address within the Address Change velocity networkInteger
velocity_profilechange_addresslastname_hphonecountThe number of hphones seen with the input address+last name combo within the Address Change velocity networkInteger
velocity_profilechange_addresslastname_nincountThe number of SSNs seen with the input address+last name combo within the Address Change velocity networkInteger
velocity_profilechange_addresslastname_timesseenThe number of times the address+last name combo has been seen within the Address Change velocity networkInteger
velocity_profilechange_fromaddress_dayssincelastseenThe number of days since the address was last seen within the Address Change velocity network (from address)Integer
velocity_profilechange_fromaddress_lastcountThe number of last names seen with the input address within the Address Change velocity network (from address)Integer
velocity_profilechange_fromaddress_nincountThe number of SSNs seen with the input address within the Address Change velocity network (from address)Integer
Phone Info (RiskSignals.phoneInfo[])
FieldDescriptionField Type
spidService Profile IdentifierString
typeType of phone line is currently associated with the numberString
popDensityPopulation density of the area associated with the phone numberFloat
portingDateDate on which the phone number was last ported between carriersDate
carrierCategoryGeneral category of the carrier (e.g., mobile, landline, VoIP) associated with the phone numberString
carrierNameName of the telecommunications carrier associated with the phone numberString
portingStatusIndicates whether the phone number has been ported from one carrier to another in the pastString
resBizIndicates whether the phone number is associated with a residential or business accountString
prepaidIndicates whether the phone number is registered as a prepaid typeBoolean
latProvides the latitude coordinates corresponding to the area code of the phone numberFloat
lonProvides the longitude coordinates corresponding to the area code of the phone numberFloat
distance.toAddressToPhoneCalculates the distance in miles between the 'to' address and the location associated with the 'to' phone numberFloat
Phone Details (RiskSignals.phoneDetails[])
FieldDescriptionField Type
dayssincemaxmaxrcvdateCurrent date - max(MaxReceivedDates)Integer
dayssincemaxmaxrecdateCurrent date - max(MaxRecordDates)Integer
dayssincemaxminrcvdateCurrent date - max(MinReceivedDates)Integer
dayssincemaxminrecdateCurrent date - max(MinRecordDates)Integer
dayssinceminmaxrcvdateCurrent date - min(MaxReceivedDates)Integer
dayssinceminmaxrecdateCurrent date - min(MaxRecordDates)Integer
dayssinceminminrcvdateCurrent date - min(MinReceivedDates)Integer
dayssinceminminrecdateCurrent date - min(MinRecordDates)Integer
landlineIs the phone a landline?Boolean
numoperatorsNumber of different phone operators/companies in recordInteger
numoperators5yearNumber of different phone operators/companies over past 5 yearsInteger
numvendorsNumber of sources for Phone dataInteger
phoneorderWhat is the rank of the phone number in the databaseInteger
voipIs the phone a voice-over the internet (VOIP) line?Boolean
wirelessIs the phone a wireless line?Boolean
Email Info (RiskSignals.emailInfo)
FieldDescriptionField Type
emailValidFlag indicating if the email is validBoolean
emailValidityScore representing the overall validity of the email addressString
emailDisposableFlag indicating if the email is a disposable emailBoolean
emailGenericFlag indicating if the email is generic type emailBoolean
emailCommonFlag indicating if the email domain is one of the common providersBoolean
emailDNSValidFlag indicating if the DNS for the email is validBoolean
emailDeliverabilityFlag indicating if the email has a deliverable addressString
emailRecentAbuseFlag indicating if there is potential fraudBoolean
emailLeakedFlag indicating if the email has been part of a data breachBoolean
emailDomainAgeDate email domain was first registeredDateTime
emailDomainTrustValue indicating if email domain is trusted, suspicious, or not ratedString
emailCatchAllIndicates if the domain accepts all email addressesBoolean
emailDomainPopularityA score representing the popularity of the email's domainString
emailFirstSeenThe date the email address was first seen in recordsDate
emailHoneypotIndicates if the email address is a known honeypot trapBoolean
emailSMTPA score representing the reliability of the email's SMTP serverInteger
emailServerErrorIndicates if the mail server is currently replying with a temporary mail server error or if the email verification system is unable to verify the email address due to a broken SMTP handshakeBoolean
emailSuggestedDomainSuggested correction for a misspelled domainString
emailUnsubscribeIndicates if the email address includes an unsubscribe linkBoolean
emailUserActivityIndicates the activity level of the email addressString
Email Domain Info (RiskSignals.emailInfo.emailDomainInfo[])
FieldDescriptionField Type
ipAddressEmail domain IP addressString
ispInternet Service Provider associated with the email domainString
orgOrganization associated with the email’s domainString
anonymousProxyFlag indicating if the email’s domain is anonymous proxyBoolean
Email Details (RiskSignals.emailDetails)
FieldDescriptionField Type
domainDomain to which the email belongsString
emailordinalRank of the email addressInteger
engagementscoreScore for how engaged the owner of the email address isInteger
free_ispIs the email provider one of the large free email providers?Integer
frequencyFrequency with which the email is checkedString
isbounceDo messages bounce when sent to the email?Boolean
isgooddomainDoes the email belong to a good domain?Boolean
ismatchedWas the email matched to a vendor list?Boolean
ispremiumIs the email classified as a premium email?Boolean
lastcheckdateWhen was the last time the owner checked this email address?Date
name_matchDoes the person's name appear in the email address?Boolean
nonbusinessIs the email a non-business email?Boolean
numvendorsNumber of sources providing email address dataInteger
Address Info (RiskSignals.addressInfo)
FieldDescriptionField Type
addressIndicatorProvides additional information about the address typeString
addressVerifiedIndicates whether the address was verifiedInteger
criminalIndexIndex value indicating criminal activity associated with the areaInteger
dwellTypeIndicates the type of dwelling for the addressString
landuseLand use category for the addressString
mailableIndicates whether the address is mailableInteger
returnCodeNumeric codes indicating errors identified during CASS processing. Codes are separated by commas. Refer to the appendix for a detailed list of codes.Integer
unitNumberMissingIndicates if the address provided on input is missing a unit numberInteger
Velocity Attributes (RiskSignals.velocityAttributes[])
FieldDescriptionField Type
categoryVelocity network categoryString
elementIdentity element being measured (e.g. HPHONE)String
timesSeenNumber of times the element has been seen in the networkInteger
datesSeen.dateMost recent dates the element was seenArray of DateTime
daysSinceLastSeenNumber of days since the element was last seenInteger
lastNameCountNumber of last names seen with the elementInteger
ABACountNumber of ABA routing numbers seen with the elementInteger
addressCountNumber of addresses seen with the elementInteger
HPhoneCountNumber of home phones seen with the elementInteger
BPhoneCountNumber of business phones seen with the elementInteger
DOBCountNumber of dates of birth seen with the elementInteger
emailCountNumber of emails seen with the elementInteger
IPCountNumber of IP addresses seen with the elementInteger
NINCountNumber of national ID numbers (SSNs) seen with the elementInteger
AccountIDCountNumber of account IDs seen with the elementInteger
Verification Result (RiskSignals.verificationResult)
FieldDescriptionField TypeField Values
matchScoreOverall match score between the input and the identity foundFloat0-100
<field>.matchTypeCodeMatch result for each input field: firstName, middleName, lastName, ssn, dobDay, dobMonth, dobYear, address, city, state, postalCode, email, phoneString
  • MATCH
  • NO_MATCH
  • NA

Messages (RiskSignals.message[])

Each message contains a code and a description. Messages are returned only when they are present.

CodeDescription
AA001Address is a Prison
AA002Address is a Temporary Address
AA003Address is a Mail Delivery Address
AA004Address is a Military Address
AA005Address is a Business Address
AA006Address Unit Number Missing
AA007Rural Route Address
AA008PO Box Address
AA009General Delivery Address
AA010Apartment or Highrise Address
AA011Street Address
AA012Name not reported at Address
AA023Check cashing store address
AA024Known fraud address
AA025Address is invalid
AA031Probable Vacant Address
AA032Address is Not Currently Receiving Delivery
AA033Unit Number Present but Not Verified
AA034Address is Not Valid at Delivery Point
AA035Input Address Matched to Known Fraud Address
AA038Input Address Matched to College or University Address
AA055A User Outside your Organization has Marked the Input Address as Associated with Suspected Fraud
AA057Name Verified at Address
AB501Bankruptcy found with full name match
AD001Driver’s License is invalid in State
AE001Potentially High-Risk Email
AE002Unable to Verify Email Domain As Being Registered
AE004Name Not Reported with E-mail
AE013Invalid Email Domain
AE014Email Domain Server Originates from Non-US Country
AE017Email Domain Server Originates from High-Risk Country
AE018Email Never Seen Before
AE019Email First Seen in the Past 1-30 Days
AE020Email First Seen in the Past 31-180 Days
AE021Email First Seen in the Past 181-365 Days
AE022Email First Seen More Than a Year Ago
AE023Email Never Encountered Before
AE024Email Encountered in the Past Month
AE025Email Encountered in the Past Year
AE026Email Encountered Over a Year Ago
AE027No Activity at Email in the Past 6 Months
AE028Low Activity at Email in the Past 6 Months
AE029Moderate Activity at Email in the Past 6 Months
AE030High Activity at Email in the Past 6 Months
AE031Email Seen at Zero Sources
AE032Email Seen at Low Number of Sources
AE033Email Seen at Moderate Number of Sources
AE034Email Seen at High Number of Sources
AE040A User Outside your Organization has Marked the Input Email as Associated with Suspected Fraud
AI002Invalid IP Address
AI003Input IP Address Matched to Known Fraud IP Address
AI008IP Originates from Non-US Country
AI010IP Originates from High-Risk Country
AI012A User Outside your Organization has Marked the Input IP Address as Associated with Suspected Fraud
AO001OFAC Alert
AP001Phone listed to Prison
AP002Phone listed to a Temporary address
AP003Phone listed to a Mail Delivery Location
AP004Phone is Cellular or Mobile
AP005Phone listed to Business
AP006Phone and Zip code mismatch
AP009Potential Phone miskey
AP010Phone reported only with different First name(s)
AP011Phone reported only with different Last name(s)
AP012Phone reported only with different Address(es)
AP013Potentially unlisted & unverified Phone
AP014Alternate Phone listed to Name and Address
AP015No Name or Address reported with Phone
AP022Phone is listed to an answering service
AP023Phone is listed to check cashing store
AP024Invalid Phone
AP030Input Phone Matched to Known Fraud Phone
AP033Input Phone Matched to a College or University Phone
AP034Phone Area Code Assigned in the Caribbean
AP038Input Phone Number is Pre-Paid
AP041Input Phone Number is a Toll-Free Number
AP042Phone Previously Ported
AP046Input Phone Number is a VOIP Line
AP047Phone Not Recognized as Valid US Phone
AP048Phone Area Code Assigned in Canada
AP062A User Outside your Organization has Marked the Input Phone as Associated with Suspected Fraud
RB017Unable to Score - Insufficient Input
RO001Input Identity found in opt-out database