{
"identity": {
"firstNameMatch": true,
"lastNameMatch": true,
"score": 900,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
"emailAddress": {
"score": 9999,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
"mobileNumber": {
"score": 199,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
"address": {
"score": 9999,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
"deviceId": {
"score": 9999,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
"geoLocation": {
"score": 9999,
"firstSeenOn": "12-31-2020",
"lastSeenOn": "01-25-2019"
},
}
Each request group will have a corresponding response group definition when available
If any top-level response elements are present, the following fields WILL be present in the response.
"score" <int> Example: 800
"firstSeenOn" <date only> Example: "12-31-2020".
"lastSeenOn" <date only> Example: "12-31-2020".
The following fields are unique and only available in the identity response section
"firstNameMatch" <bool> [true|false]
"lastNameMatch" <bool> [true|false]
When the API is unable to locate any one of the requested element groups, it will be returned as null.
null indicates that either
9999 indicates that we have a match for a category, but nothing positive / negative to report.
Ingo will respond as to whether Ingo has interacted with a customer using each of the following identifiers, along with the date each identifier was first used, and the date that each identifier was last used in the Ingo ecosystem. Identifiers will be reported separately - i.e. Ingo will respond on the email, address etc. separately, even if the Name/SSN do not match.
MAX------------------------------------------------------------MIN
|----->>---POSITIVE---->>----| NEUTRAL | >> NEGATIVE BUCKETS >> |
1,000----(continuum)--------499-------300 <299> <199> <99> <9>
If Ingo has had a negative experience with a particular identifier, Ingo will respond with a score indicating the nature of that negative experience in one of four discrete "buckets", as follows:
This code indicates that transactions associated with an identifier had indicators closely associated with stolen or compromised identities (whether or not transactions were accepted or turned out to be fraudulent), including but not limited to the following:
This code indicates that one or more transactions associated with that identifier were highly likely or confirmed to be fraudulent, including but not limited to the following:
This code indicates that one or more transactions associated with that identifier resulted in a returned check under suspicious circumstances or other suspicious activity, but did not necessarily rise to the level of likely fraud, including but not limited to the following:
This code indicates that one or more transactions associated with that identifier indicated high-risk behavior, but that does not rise to the level of likely fraud or suspicious activity, including but not limited to the following:
NOTES:
Likely Fraud, Suspicious Activity, and High-Risk activity associated with a certain identity can be the result of the person who actually owns that identity engaging in certain behavior, but can also result from behavior by someone else using such person's stolen or forged identity. Important Notes:
A negative score on an address indicates that Ingo has seen the indicated activity at that address. Scores may be associated with a match of Address First Line + Zip Code – this is an indication of behavior at the building level, but may not indicate behavior in a particular apartment or unit. Apartment or unit information is only indicated if Ingo has matched the Address Line 1 + Line 2 + Zip code. Additionally, a match at an address does NOT necessarily indicate that the person currently at such address has engaged in such activity, as multiple people can live at one address, some addresses are for high occupancy buildings such as apartments, and people move regularly. We urge caution in using these scores in regard to making decisions about any particular individual.
Geocodes may be flagged for high-risk activity due to unusually high transaction velocity. This is an indicator, but not necessarily determinative, of high risk or fraudulent activity.
If and only if Ingo's experience with an individual (SSN/name/DOB) does NOT fall into one of the foregoing negative categories, Ingo may return a score between 300 and 1,000 for the individual. Ingo does not return transactional scores for other identifiers such as devices, addresses, or email addresses. A score of 300-499 indicates negative or no positive experience with an individual. Scores above 500 indicate increasing levels of positive transactional experience with an individual, such as repeat usage of Ingo's partner check cashing services with no check returns. The higher the score, the more extensive and positive Ingo's experience.
A response of 9999 indicates that Ingo has no reportable positive or negative transactional information about an indicator, either because they passed KYC but never conducted a transaction, or because the transactional information about such indicator is not reportable due to compliance or other reasons.
When the request contains "invalid" field data Ingo will still send a valid response, however, the response will include a validationErrors property describing the invalid data and the corresponding response group will be null.
{
"identity": {
"firstNameMatch": true,
"lastNameMatch": true,
"score": 9,
"firstSeenOn": "06-23-2021",
"lastSeenOn": "06-24-2021"
},
"emailAddress": null,
"mobileNumber": {
"score": 299,
"firstSeenOn": "12-11-2020",
"lastSeenOn": "06-24-2021"
},
"address": {
"matchType": "Full",
"score": 9999,
"firstSeenOn": "05-19-2020",
"lastSeenOn": "06-24-2021"
},
"deviceId": {
"score": 9999,
"firstSeenOn": "12-13-2018",
"lastSeenOn": "06-24-2021"
},
"geoLocation": null,
"validationErrors": [
{
"fieldName": "EmailAddress",
"error": "'Email Address' is not a valid email address."
}
]
}