Age Verification

The Age Verification module checks whether an individual meets a specified age requirement by verifying their date of birth (DOB) against trusted data sources. This module is commonly used in industries with age restrictions, such as gaming, alcohol sales, and financial services.

The module has two variants using a US data source. Both variants return the same set of capability categories and default outcomes. The difference is in which input fields are required.

Variant	Required inputs	Optional inputs
US Source 1 (including DOB)	Full name, DOB, current address	Previous addresses, mobile phone, personal email, SSN
US Source 1 (including DOB and SSN)	Full name, DOB, current address, SSN	Previous addresses, mobile phone, personal email

Age Verification: US Source 1 (including DOB)

This variant performs an age verification identity check against US data sources using the subject’s name, address, and date of birth (DOB). It verifies whether an individual meets a required age threshold by cross-referencing submitted personal information against trusted US consumer and public record databases.

This module is typically used in industries where age-gating is a regulatory or business requirement, such as gaming, alcohol and tobacco sales, financial services, and any platform subject to COPPA (Children’s Online Privacy Protection Act) compliance.

For the full list of capabilities returned by this variant, see Capabilities below.

Age Verification: US Source 1 (including DOB and SSN)

This variant performs the same identity check as US Source 1 (including DOB) but requires the subject’s Social Security Number (SSN) as a mandatory input rather than an optional one.

Requiring SSN increases the confidence of the verification match because SSN is a highly unique identifier. It enables stronger cross-referencing against consumer databases and improves the reliability of Trust USA risk assessments, which evaluate relationships between identity elements such as SSN, address, and phone number. If you can collect SSN from your users, you should prefer this variant for higher-assurance age verification.

For the full list of capabilities returned by this variant, see Capabilities below. The capabilities are identical to US Source 1 (including DOB).

Capabilities

All Age Verification variants return the same structured set of result codes grouped into capability categories. Each category surfaces specific risk signals, match outcomes, and compliance flags that downstream evaluation logic can act on.

Subject risk codes

These codes flag high-level concerns about the identity record itself, independent of any individual data field match.

Code	Description
resultcode.subject.deceased	The identity record is associated with a deceased individual. The subject’s personal information matches a record in a death index or similar mortality database. This is a critical fraud indicator, as deceased identities are commonly exploited for synthetic identity fraud.
resultcode.thin.file	The subject has a “thin file”, meaning there are very few records available in consumer databases to verify against. This is common for younger individuals (aged 18–21), recent immigrants, or people with limited credit and public record history. A thin file does not indicate fraud, but it reduces the confidence of any verification match.
resultcode.data.strength.alert	The overall strength of the data available for this identity is weak. This may indicate that the records found are sparse, inconsistent, or insufficient for a high-confidence verification. It serves as a general signal to apply additional scrutiny.

Name risk codes

These codes indicate whether the submitted name matched the name on file in the data source.

Code	Description
resultcode.last.name.does.not.match	The submitted last name does not match the last name in the reference data source. This could indicate a data entry error, a name change (such as after marriage), or a fraudulent submission.
resultcode.first.name.does.not.match	The submitted first name does not match the reference record. Common causes include nicknames (e.g. “Bill” vs “William”), typographical errors, or deliberate misrepresentation.

Address risk codes

Address risk codes are the most granular capability in this module. They cover match failures at the field level, deliverability issues, stability and velocity signals, and “warm address” flags that identify high-risk location types.

• Address match codes:

The codes below indicate specific mismatches between the submitted address and the reference data, as well as tolerance levels for near matches.

Code	Description
resultcode.address.does.not.match	The submitted address does not match any address on file for the subject. This is a broad mismatch signal.
resultcode.street.number.does.not.match	The street number portion of the address does not match. The street name may be correct, but the building number differs.
resultcode.street.name.does.not.match	The street name does not match the reference record. The subject may live at a different address entirely, or there may be a spelling error.
resultcode.address.within.tolerance	The address does not match exactly, but falls within an acceptable tolerance range. For example, the ZIP code may differ slightly but the address is geographically close to the reference.
resultcode.city.does.not.match	The submitted city does not match the reference address.
resultcode.state.does.not.match	The submitted state does not match the reference address.
resultcode.zip.does.not.match	The submitted ZIP code does not match the reference record.

• Address type and deliverability codes:

The codes below indicate issues related to the type of address submitted (e.g. PO Box, military address) and whether the address is deliverable according to USPS records. These signals can indicate higher fraud risk or data quality issues.

Code	Description
resultcode.input.address.is.po.box	The submitted address is a PO Box. PO Boxes are sometimes flagged because they can obscure the subject’s true residential location.
resultcode.located.address.is.po.box	The address found in the reference data for this subject is a PO Box, even though the submitted address may be a street address.
resultcode.input.address.is.not.deliverable	The submitted address is not a valid deliverable address according to USPS records.
resultcode.located.address.is.not.deliverable	The located reference address for the subject is not deliverable.
deliverable.input.invalid.delivery.address	The address cannot receive mail delivery. It may be a vacant lot, an unrecognised address, or otherwise invalid.
deliverable.input.deliverable.after.dropping.bldg	The address becomes deliverable only after removing the building or unit number. This suggests the primary address is valid but the specific unit may not exist.
deliverable.input.general.delivery.address	The address is a general delivery address, meaning mail is held at a post office for the recipient to collect rather than being delivered to a specific location.
deliverable.input.missing.building.number	The address is missing a building or house number, making it incomplete.
deliverable.input.invalid.premise.number	The premise (building) number in the address is not valid for the given street.
deliverable.input.missing.box.number	The address appears to reference a PO Box or mailbox but is missing the box number.
deliverable.input.invalid.box.number	The box number provided does not exist at the given post office or mail facility.
deliverable.input.no.usps	The address has no USPS (United States Postal Service) record. It may be a new development, a rural address, or simply non-existent.
deliverable.input.number.needs.correction	The street or building number in the address appears to contain an error and requires correction.
deliverable.input.military.address	The address is a military address (APO/FPO/DPO), which follows a different delivery format.
deliverable.input.business.address	The address is registered as a commercial or business address rather than a residential one.

• Address risk and behaviour signals:

The codes below flag risk patterns related to address history, stability, and velocity. These signals help identify potentially fraudulent or suspicious address usage.

Code	Description
resultcode.newer.record.found	A more recent address record has been found for this subject, suggesting they may have moved. The submitted address may be outdated.
resultcode.address.velocity.alert	The address has been used in an unusually high number of identity verification requests within a short time period. This velocity pattern may indicate that multiple fraudulent identities are being registered at the same location.
resultcode.address.stability.alert	The subject’s address history shows a pattern of frequent changes. Low address stability can be a risk factor in fraud models.
resultcode.address.longevity.alert	The subject has been associated with the submitted address for a very short period. A short tenure at an address can indicate recently fabricated identity data.
resultcode.address.location.alert	The geographic location of the address raises a risk flag, for example if it falls in a region associated with higher fraud rates.
resultcode.single.address.in.file	Only one address has ever been recorded for this subject. While not inherently suspicious, it may indicate a thin file or limited history.
resultcode.alternate.address.alert	An alternate address was found for the subject that could not be verified or raises concern.
resultcode.high.risk.address.alert	The address has been identified as high-risk based on historical fraud data or other intelligence.

• Warm address alerts (located address):

A “warm address” is an address type that, by its nature, is associated with higher identity fraud risk. These addresses are not typical residential locations, making them unreliable for identity verification purposes.

Code	Description
resultcode.warm.address.alert	The located address (from reference data) is flagged as a warm address of unspecified type.
resultcode.warm.address.alert.prison	The located address is a correctional facility.
resultcode.warm.address.alert.hospital	The located address is a hospital.
resultcode.warm.address.alert.mail.drop	The located address is a mail drop or commercial mailbox rental (e.g. a UPS Store mailbox). These are frequently used to create fictitious residential addresses.
resultcode.warm.address.alert.hotel	The located address is a hotel or motel.
resultcode.warm.address.alert.campground	The located address is a campground or RV park.
resultcode.warm.address.alert.college.university	The located address is a college or university campus.
resultcode.warm.address.alert.uspo	The located address is a United States Post Office.

• Warm address alerts (input address):

These codes apply the same warm address classification to the address submitted by the subject, rather than the address found in reference data.

Code	Description
resultcode.warm.input.address.alert	The submitted address is flagged as a warm address of unspecified type.
resultcode.warm.input.address.alert.prison	The submitted address is a correctional facility.
resultcode.warm.input.address.alert.hospital	The submitted address is a hospital.
resultcode.warm.input.address.alert.mail.drop	The submitted address is a mail drop or commercial mailbox rental.
resultcode.warm.input.address.alert.hotel	The submitted address is a hotel or motel.
resultcode.warm.input.address.alert.campground	The submitted address is a campground or RV park.
resultcode.warm.input.address.alert.college.university	The submitted address is a college or university campus.
resultcode.warm.input.address.alert.uspo	The submitted address is a United States Post Office.

DOB risk codes

These codes evaluate whether the submitted date of birth matches the reference data and whether age-related thresholds are met.

Code	Description
resultcode.yob.does.not.match	The submitted year of birth does not match the reference record.
resultcode.mob.does.not.match	The submitted month of birth does not match the reference record.
resultcode.day.of.birth.does.not.match	The submitted day of birth does not match the reference record.
resultcode.yob.within.one.year	The submitted year of birth is within one year of the reference record. This may indicate a typographical error rather than deliberate misrepresentation.
resultcode.no.dob.available	No date of birth is available in the reference data for comparison.
resultcode.no.mob.available	No month of birth is available in the reference data. The year may still be present.
resultcode.day.of.birth.not.available	The day of birth is not present in the reference data.
resultcode.age.below.minimum	The subject’s age (calculated from the submitted DOB) falls below the configured minimum age threshold.
resultcode.age.above.maximum	The subject’s age exceeds the configured maximum age threshold.

Score card result

The score card result provides a summary-level outcome for the entire identity verification check.

Code	Description
id.success	The identity verification was successful. The submitted information sufficiently matched reference data to pass the configured thresholds.
id.failure	The identity verification failed. The submitted information did not match reference data at the required confidence level.
id.partial	A partial match was achieved. Some identity elements matched while others did not. This result typically requires further review or additional verification steps.

Age match capabilities

These codes report the specific outcome of the age verification check against the configured age threshold.

Code	Description
resultcode.of.age	The subject meets or exceeds the required minimum age threshold.
resultcode.under.age	The subject is below the required minimum age threshold.
resultcode.confirm.age	The system was unable to confirm the subject’s age. Insufficient data was available to make a definitive determination.

Subject restricted capabilities

This category flags regulatory restrictions related to the subject’s age.

Code

Description

resultcode.coppa.alert

The subject may be under 13 years of age, triggering a COPPA (Children’s Online Privacy Protection Act) alert. COPPA is a US federal law that requires operators of websites and online services to obtain verifiable parental consent before collecting personal information from children under 13. This alert signals that you must not collect, use, or disclose the child’s personal information without appropriate parental consent mechanisms in place.

Alert list capabilities

These codes indicate that one or more of the subject’s identity elements match an entry on a known-risk or blacklist database. These are strong fraud indicators.

Code	Description
resultcode.blacklist.alert.ssn	The submitted Social Security Number (SSN) appears on a blacklist. It may be associated with known fraudulent activity.
resultcode.blacklist.alert.address	The submitted address appears on a blacklist.
resultcode.blacklist.alert.ip	The IP address associated with the request appears on a blacklist.
resultcode.blacklist.alert.phone	The submitted phone number appears on a blacklist.
resultcode.blacklist.alert.email	The submitted email address appears on a blacklist.
resultcode.blacklist.alert.domain	The email domain appears on a blacklist (e.g. a disposable email provider commonly used for fraud).
resultcode.blacklist.alert.document.number	The submitted document number (e.g. driver’s licence or passport number) appears on a blacklist.
resultcode.blacklist.alert.address.zip	The ZIP code of the submitted address appears on a blacklist.
resultcode.blacklist.alert.located.ssn	The SSN found in the reference data (not the submitted SSN) appears on a blacklist.

Trust USA risk capabilities

Trust USA risk codes are proprietary risk signals that evaluate the relationships between pairs of identity elements. Each code represents either a match or a mismatch between two specific data points (e.g. “does this SSN appear at this address?”). A prefix of I indicates the relationship was evaluated using the input (submitted) data, while L indicates the check used located (reference) data.

These codes feed into a composite fraud risk assessment. The presence of multiple mismatch codes across different element pairs increases the overall fraud risk score.

Element pair codes

Code	Elements evaluated	Description
ADDR4	Address (4-line)	Full address match at the 4-line level (street, city, state, ZIP).
ADDR	Address	General address match.
IADDR4	Input address (4-line)	The submitted address matches at the 4-line level in cross-reference checks.
IADDR	Input address	The submitted address was evaluated in cross-reference risk checks.
IALTADDR	Input alternate address	An alternate address associated with the input identity was flagged.
IALT	Input alternate data	Alternate identity data associated with the input was evaluated.
IBADDR	Input business address	The input address was evaluated against business address records.
IBDBA	Input business DBA	The input was cross-referenced against “Doing Business As” (DBA) records.
IBDBANAME	Input business DBA name	The business DBA name associated with the input was evaluated.
IBFEIN	Input business FEIN	The input was cross-referenced with a Federal Employer Identification Number (FEIN).
IBNAME	Input business name	The input business name was evaluated.
IDOC	Input document number	The submitted document number was evaluated in risk checks.
IEMAILDOM	Input email domain	The domain of the submitted email was evaluated for risk.
IEMAIL	Input email	The submitted email address was evaluated in risk checks.
IEMAILIADDR	Input email + input address	Cross-reference between the submitted email and address.
IEMAILIIPADDR	Input email + input IP address	Cross-reference between the submitted email and IP address.
IEMAILIPHONE	Input email + input phone	Cross-reference between the submitted email and phone number.
IEMAILISSN9	Input email + input SSN (full)	Cross-reference between the submitted email and full SSN.
IFIRST	Input first name	The submitted first name was evaluated in risk checks.
IIPADDRIADDR	Input IP address + input address	Cross-reference between the IP address and the submitted address.
IIPADDR	Input IP address	The IP address was evaluated for risk.
IIPADDRIPHONE	Input IP address + input phone	Cross-reference between the IP address and phone number.
IIPADDRISSN9	Input IP address + input SSN (full)	Cross-reference between the IP address and full SSN.
IIP	Input IP	General IP address risk signal.
ILAST	Input last name	The submitted last name was evaluated in risk checks.
ILNAME4	Input last name (4-char)	The first four characters of the submitted last name were evaluated. Used for fuzzy matching.
INAME2	Input name (2-part)	The submitted first and last name combination was evaluated.
INAME4	Input name (4-part)	A four-part name (e.g. first, middle, last, suffix) was evaluated.
INAME	Input name	General name risk evaluation.
IPHONEIADDR	Input phone + input address	Cross-reference between the submitted phone number and address.
IPHONEISSN9	Input phone + input SSN (full)	Cross-reference between the submitted phone number and full SSN.
IPHONE	Input phone	The submitted phone number was evaluated in risk checks.
ISKU	Input SKU	A unique identifier or session key was evaluated.
ISNAME	Input surname	The submitted surname was evaluated.
ISNBR	Input street number	The submitted street number was evaluated.
ISSN4	Input SSN (last 4)	The last four digits of the submitted SSN were evaluated.
ISSN9	Input SSN (full 9-digit)	The full submitted SSN was evaluated.
ISTRNZIP	Input street name + ZIP	Cross-reference between the submitted street name and ZIP code.
IZIP	Input ZIP code	The submitted ZIP code was evaluated.
LDOC	Located document number	The document number found in reference data was evaluated.
LFIRST	Located first name	The first name in reference data was evaluated.
LLAST	Located last name	The last name in reference data was evaluated.
LNAME4	Located name (4-char)	The first four characters of the located last name were evaluated.
LPHONE	Located phone	The phone number in reference data was evaluated.
LSAC	Located sub-area code	A sub-area code in the located data was evaluated.
LSNAME	Located surname	The surname in reference data was evaluated.
LSNBR	Located street number	The street number in reference data was evaluated.
LSSN4	Located SSN (last 4)	The last four digits of the SSN in reference data were evaluated.
LSSN9	Located SSN (full 9-digit)	The full SSN in reference data was evaluated.
LZIP	Located ZIP code	The ZIP code in reference data was evaluated.
NAME2	Name (2-part)	A two-part name combination was evaluated using both input and located data.
NAME4	Name (4-part)	A four-part name was evaluated using both input and located data.
NAME	Name	General name match evaluation across input and located data.
PHONE	Phone	General phone match evaluation across input and located data.
SSN9	SSN (full 9-digit)	Full SSN match evaluation across input and located data.
STRNZIP	Street name + ZIP	Street name and ZIP combination evaluated across input and located data.

Trust USA result capabilities

The Trust USA result provides the overall risk determination based on the aggregated Trust USA risk codes.

Code	Description
pass	The composite risk assessment indicates low fraud risk. The identity elements are consistent and do not trigger significant risk signals.
fail	The composite risk assessment indicates high fraud risk. Multiple identity elements are inconsistent or match known-risk patterns.
refer	The risk assessment is inconclusive. The identity could not be confidently classified as low or high risk and requires manual review or additional verification.

SSN capabilities

SSN matching alerts, validation and issuance alerts

Value	Description
resultcode.ssn.does.not.match	SSN Does Not Match
resultcode.ssn.within.one.digit	SSN Does Not Match, Within Tolerance
resultcode.ssn.not.available	SSN Not Available
resultcode.ssn.not.valid	SSN Is Invalid
resultcode.input.ssn.is.itin	Input SSN is an ITIN
resultcode.located.itin	ITIN Located
resultcode.ssn.issued.prior.to.dob	SSN Issued Prior to DOB
resultcode.ssn.tied.to.multiple.names	SSN Tied to Multiple Names
ssn.does.not.match	SSN Does Not Match (legacy)
ssn.within.one.digit	SSN Does Not Match, Within Tolerance (legacy)
ssn.not.available	SSN Not Available (legacy)
ssn.not.valid	SSN Is Invalid (legacy)
input.ssn.is.itin	Input SSN is an ITIN (legacy)
located.itin	ITIN Located (legacy)
located.itinm	ITIN Located (alternate legacy alias)
ssn.issued.prior.to.dob	SSN Issued Prior to DOB (legacy)
ssn.tied.to.multiple.names	SSN Tied to Multiple Names (legacy)

Match capabilities

Individual Located or Not Located

Value	Description
result.match	Match
result.no.match	No Match
result.match.restricted	Match Restricted

Default outcomes

All Age Verification variants share the same default outcomes, which can be used in evaluation and routing logic within the journey designer.

Outcome	Condition	Description
Of Age	Age match result includes resultcode.of.age	The subject meets or exceeds the required minimum age threshold. The journey can proceed.
Under Age	Age match result includes resultcode.under.age	The subject is below the required minimum age threshold. The journey typically routes to rejection.
Match Restricted	Subject restricted capabilities include resultcode.coppa.alert	The subject may be under 13 years of age, triggering COPPA restrictions. You must not collect, use, or disclose the child’s personal information without verifiable parental consent.
Can Not Confirm Age	Age match result includes resultcode.confirm.age	The system was unable to confirm the subject’s age due to insufficient data. The journey may route to manual review or prompt the user to provide additional information.
ERROR	Default (no conditions matched)	An unexpected error occurred during processing. This fallback outcome typically indicates a system-level issue.

Input payload

The following is a sample payload used to submit subject details to the Age Verification module for processing.

The context.config object is optional. Omit it to use the module’s default age threshold.

JSON

{
  "resourceId": "<resourceId>",
  "context": {
    "config": {
      "ageToCheck": "21"
    },
    "subject": {
      "identity": {
        "firstName": "<string>",
        "lastNames": ["<string>"],
        "dateOfBirth": "<YYYY-MM-DD>",
        "phones": [
          {
            "type": "mobile",
            "number": "<string>"
          }
        ],
        "currentAddress": {
          "lines": ["<string>"],
          "locality": "<string>",
          "dependentLocality": "<string>",
          "postalCode": "<string>",
          "country": "<string>"
        }
      }
    }
  }
}

Field	Required	Description
config.ageToCheck	No	Age threshold to verify the subject against, as a string (for example, "21").
identity.firstName	Yes	First name of the subject.
identity.lastNames	Yes	Array containing the last name(s) of the subject.
identity.dateOfBirth	No	Date of birth in YYYY-MM-DD format.
identity.phones[].type	No	Type of phone number (for example, "mobile").
identity.phones[].number	No	Phone number of the subject.
identity.currentAddress.lines	No	Array of address lines. Accepts up to 2 items.
identity.currentAddress.locality	No	Town or city.
identity.currentAddress.dependentLocality	No	State or region.
identity.currentAddress.postalCode	No	Postal or ZIP code.
identity.currentAddress.country	No	Country code (for example, "US").

Sample response

The following is a sample response for a subject confirmed to be of age.

JSON

{
  "response": {
    "advice": {
      "age_restricted_capabilities": [],
      "subject_risk_capabilities": [],
      "name_risk_capabilities": [],
      "address_risk_capabilities": [],
      "dob_risk_capabilities": [],
      "ssn_risk_capabilities": [],
      "alert_list_capabilities": [],
      "acceptance_result_capabilities": [],
      "match_result_capabilities": [],
      "age_result_capabilities": ["resultcode.of.age"],
      "trust_usa_risk_capabilities": [],
      "trust_usa_result_capabilities": []
    },
    "outcome": "Of Age"
  }
}

US Source 1 (including DOB and SSN)

Capabilities

Subject risk codes

High-level concerns about the identity record itself, independent of any individual data field match.

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Codes indicating whether the submitted name matched the name on file in the data source.

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk codes covering field-level match failures, deliverability issues, address stability and velocity signals, and warm-address flags that identify high-risk location types.

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

Codes evaluating whether the submitted date of birth matches the reference data and whether age-related thresholds are met.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

Score card result

A summary-level outcome for the entire identity verification check.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Age match capabilities

Codes reporting the specific outcome of the age verification check against the configured age threshold.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

Flags regulatory restrictions related to the subject’s age, such as a COPPA alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Codes indicating that one or more of the subject’s identity elements match an entry on a known-risk or blacklist database. These are strong fraud indicators.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Proprietary Trust USA risk signals that evaluate the relationships between pairs of identity elements, each representing a match or mismatch between two data points, feeding into a composite fraud risk assessment.

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

The overall Trust USA risk determination based on the aggregated Trust USA risk codes.

Value	Description
pass	Pass
fail	Fail
refer	Refer

Input payload

The following is a sample payload used to submit data to the US Source 1 (including DOB and SSN) module for processing.

JSON

{
  "equalToFile": "age-request-confirmAge.json"
}

Field	Required	Description
FullName	Yes	The subject’s full name, including given and family names.
DateOfBirth	Yes	The subject’s date of birth.
CurrentAddress/lines	No	The full address as one or more free-form lines, used when structured address components are not available.
CurrentAddress/premise	Yes	The premise (building name or number) of the current address.
CurrentAddress/thoroughfare	Yes	The street or thoroughfare of the current address.
CurrentAddress/building	No	The building name or number of the current address.
CurrentAddress/subBuilding	No	The sub-building (for example, flat or unit) of the current address.
CurrentAddress/locality	No	The locality (town or city) of the current address.
CurrentAddress/administrativeArea	No	The administrative area (for example, state, province, or county) of the current address.
CurrentAddress/dependentLocality	No	The dependent locality (a smaller area within the locality) of the current address.
CurrentAddress/postalCode	Yes	The postal or ZIP code of the current address.
CurrentAddress/country	No	The country of the current address.
SSN	Yes	The subject’s Social Security Number.
PreviousAddresses	No	The subject’s previous residential addresses.
MobilePhone	No	The subject’s mobile telephone number.
PersonalEmail	No	The subject’s personal email address.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {
      "acceptance_result_capabilities": [],
      "address_risk_capabilities": [
        "resultcode.single.address.in.file"
      ],
      "age_restricted_capabilities": [],
      "age_result_capabilities": [
        "resultcode.confirm.age"
      ],
      "alert_list_capabilities": [],
      "dob_risk_capabilities": [
        "resultcode.no.dob.available"
      ],
      "match_result_capabilities": [],
      "name_risk_capabilities": [],
      "ssn_risk_capabilities": [],
      "subject_risk_capabilities": [],
      "trust_usa_result_capabilities": [],
      "trust_usa_risk_capabilities": []
    },
    "outcome": "Can Not Confirm Age"
  }
}

US Source 1 (including DOB)

Capabilities

Subject risk codes

High-level concerns about the identity record itself, independent of any individual data field match.

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Codes indicating whether the submitted name matched the name on file in the data source.

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk codes covering field-level match failures, deliverability issues, address stability and velocity signals, and warm-address flags that identify high-risk location types.

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

Codes evaluating whether the submitted date of birth matches the reference data and whether age-related thresholds are met.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

Score card result

A summary-level outcome for the entire identity verification check.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Age match capabilities

Codes reporting the specific outcome of the age verification check against the configured age threshold.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

Flags regulatory restrictions related to the subject’s age, such as a COPPA alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Codes indicating that one or more of the subject’s identity elements match an entry on a known-risk or blacklist database. These are strong fraud indicators.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Proprietary Trust USA risk signals that evaluate the relationships between pairs of identity elements, each representing a match or mismatch between two data points, feeding into a composite fraud risk assessment.

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

The overall Trust USA risk determination based on the aggregated Trust USA risk codes.

Value	Description
pass	Pass
fail	Fail
refer	Refer

Input payload

The following is a sample payload used to submit data to the US Source 1 (including DOB) module for processing.

JSON

{
  "equalToFile": "age-request-confirmAge.json"
}

Field	Required	Description
FullName	Yes	The subject’s full name, including given and family names.
DateOfBirth	Yes	The subject’s date of birth.
CurrentAddress/lines	No	The full address as one or more free-form lines, used when structured address components are not available.
CurrentAddress/premise	Yes	The premise (building name or number) of the current address.
CurrentAddress/thoroughfare	Yes	The street or thoroughfare of the current address.
CurrentAddress/building	No	The building name or number of the current address.
CurrentAddress/subBuilding	No	The sub-building (for example, flat or unit) of the current address.
CurrentAddress/locality	No	The locality (town or city) of the current address.
CurrentAddress/administrativeArea	No	The administrative area (for example, state, province, or county) of the current address.
CurrentAddress/dependentLocality	No	The dependent locality (a smaller area within the locality) of the current address.
CurrentAddress/postalCode	Yes	The postal or ZIP code of the current address.
CurrentAddress/country	No	The country of the current address.
PreviousAddresses	No	The subject’s previous residential addresses.
MobilePhone	No	The subject’s mobile telephone number.
PersonalEmail	No	The subject’s personal email address.
SSN	No	The subject’s Social Security Number.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {
      "acceptance_result_capabilities": [],
      "address_risk_capabilities": [
        "resultcode.single.address.in.file"
      ],
      "age_restricted_capabilities": [],
      "age_result_capabilities": [
        "resultcode.confirm.age"
      ],
      "alert_list_capabilities": [],
      "dob_risk_capabilities": [
        "resultcode.no.dob.available"
      ],
      "match_result_capabilities": [],
      "name_risk_capabilities": [],
      "ssn_risk_capabilities": [],
      "subject_risk_capabilities": [],
      "trust_usa_result_capabilities": [],
      "trust_usa_risk_capabilities": []
    },
    "outcome": "Can Not Confirm Age"
  }
}

US Source 2 (including DOB and SSN)

Capabilities

Subject risk codes

High-level concerns about the identity record itself, independent of any individual data field match.

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Codes indicating whether the submitted name matched the name on file in the data source.

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk codes covering field-level match failures, deliverability issues, address stability and velocity signals, and warm-address flags that identify high-risk location types.

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

Codes evaluating whether the submitted date of birth matches the reference data and whether age-related thresholds are met.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

Score card result

A summary-level outcome for the entire identity verification check.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Age match capabilities

Codes reporting the specific outcome of the age verification check against the configured age threshold.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

Flags regulatory restrictions related to the subject’s age, such as a COPPA alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Codes indicating that one or more of the subject’s identity elements match an entry on a known-risk or blacklist database. These are strong fraud indicators.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Proprietary Trust USA risk signals that evaluate the relationships between pairs of identity elements, each representing a match or mismatch between two data points, feeding into a composite fraud risk assessment.

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

The overall Trust USA risk determination based on the aggregated Trust USA risk codes.

Value	Description
pass	Pass
fail	Fail
refer	Refer

US Source 2 (including DOB)

Capabilities

Subject risk codes

High-level concerns about the identity record itself, independent of any individual data field match.

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Codes indicating whether the submitted name matched the name on file in the data source.

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk codes covering field-level match failures, deliverability issues, address stability and velocity signals, and warm-address flags that identify high-risk location types.

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

Codes evaluating whether the submitted date of birth matches the reference data and whether age-related thresholds are met.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

Score card result

A summary-level outcome for the entire identity verification check.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Age match capabilities

Codes reporting the specific outcome of the age verification check against the configured age threshold.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

Flags regulatory restrictions related to the subject’s age, such as a COPPA alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Codes indicating that one or more of the subject’s identity elements match an entry on a known-risk or blacklist database. These are strong fraud indicators.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Proprietary Trust USA risk signals that evaluate the relationships between pairs of identity elements, each representing a match or mismatch between two data points, feeding into a composite fraud risk assessment.

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

The overall Trust USA risk determination based on the aggregated Trust USA risk codes.

Value	Description
pass	Pass
fail	Fail
refer	Refer

US Source 3 (including DOB and SSN)

Capabilities

Subject risk codes

Subject Risk Codes

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Name matching alerts

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk insights and matching alerts

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

DOB matching alerts.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

SSN capabilities

SSN matching alerts, validation and issuance alerts

Value	Description
resultcode.ssn.does.not.match	SSN Does Not Match
resultcode.ssn.within.one.digit	SSN Does Not Match, Within Tolerance
resultcode.ssn.not.available	SSN Not Available
resultcode.ssn.not.valid	SSN Is Invalid
resultcode.input.ssn.is.itin	Input SSN is an ITIN
resultcode.located.itin	ITIN Located
resultcode.ssn.issued.prior.to.dob	SSN Issued Prior to DOB
resultcode.ssn.tied.to.multiple.names	SSN Tied to Multiple Names
ssn.does.not.match	SSN Does Not Match (legacy)
ssn.within.one.digit	SSN Does Not Match, Within Tolerance (legacy)
ssn.not.available	SSN Not Available (legacy)
ssn.not.valid	SSN Is Invalid (legacy)
input.ssn.is.itin	Input SSN is an ITIN (legacy)
located.itin	ITIN Located (legacy)
located.itinm	ITIN Located (alternate legacy alias)
ssn.issued.prior.to.dob	SSN Issued Prior to DOB (legacy)
ssn.tied.to.multiple.names	SSN Tied to Multiple Names (legacy)

Score card result

Summary results/score card results.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Match capabilities

Individual Located or Not Located

Value	Description
result.match	Match
result.no.match	No Match
result.match.restricted	Match Restricted

Age match capabilities

Individual of age, under age, can not confirm age, or match restricted.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

COPPA Alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Alerts.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Trust USA Risk Capabilities

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

Trust USA Result Capabilities

Value	Description
pass	Pass
fail	Fail
refer	Refer

Input payload

The following is a sample payload used to submit data to the US Source 3 (including DOB and SSN) module for processing.

JSON

{
  "equalToFile": "age-request-confirmAge.json"
}

Field	Required	Description
FullName	Yes	The subject’s full name, including given and family names.
DateOfBirth	Yes	The subject’s date of birth.
CurrentAddress/lines	No	The full address as one or more free-form lines, used when structured address components are not available.
CurrentAddress/premise	Yes	The premise (building name or number) of the current address.
CurrentAddress/thoroughfare	Yes	The street or thoroughfare of the current address.
CurrentAddress/building	No	The building name or number of the current address.
CurrentAddress/subBuilding	No	The sub-building (for example, flat or unit) of the current address.
CurrentAddress/locality	No	The locality (town or city) of the current address.
CurrentAddress/administrativeArea	No	The administrative area (for example, state, province, or county) of the current address.
CurrentAddress/dependentLocality	No	The dependent locality (a smaller area within the locality) of the current address.
CurrentAddress/postalCode	Yes	The postal or ZIP code of the current address.
CurrentAddress/country	No	The country of the current address.
SSN	Yes	The subject’s Social Security Number.
PreviousAddresses	No	The subject’s previous residential addresses.
MobilePhone	No	The subject’s mobile telephone number.
PersonalEmail	No	The subject’s personal email address.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {
      "acceptance_result_capabilities": [],
      "address_risk_capabilities": [
        "resultcode.single.address.in.file"
      ],
      "age_restricted_capabilities": [],
      "age_result_capabilities": [
        "resultcode.confirm.age"
      ],
      "alert_list_capabilities": [],
      "dob_risk_capabilities": [
        "resultcode.no.dob.available"
      ],
      "match_result_capabilities": [],
      "name_risk_capabilities": [],
      "ssn_risk_capabilities": [],
      "subject_risk_capabilities": [],
      "trust_usa_result_capabilities": [],
      "trust_usa_risk_capabilities": []
    },
    "outcome": "Can Not Confirm Age"
  }
}

US Source 3 (including DOB)

Capabilities

Subject risk codes

Subject Risk Codes

Value	Description
resultcode.subject.deceased	Subject is deceased
resultcode.thin.file	Thin File
resultcode.data.strength.alert	Data Strength Alert

Name risk codes

Name matching alerts

Value	Description
resultcode.last.name.does.not.match	Last Name Does Not Match
resultcode.first.name.does.not.match	First Name Does Not Match

Address risk codes

Address risk insights and matching alerts

Value	Description
resultcode.address.does.not.match	Address Does Not Match
resultcode.street.number.does.not.match	Street Number Does Not Match
resultcode.street.name.does.not.match	Street Name Does Not Match
resultcode.address.within.tolerance	Address Does Not Match, Within Tolerance
resultcode.city.does.not.match	City Does Not Match
resultcode.state.does.not.match	State Does Not Match
resultcode.zip.does.not.match	Zip Code Does Not Match
resultcode.input.address.is.po.box	Input Address is a PO Box
resultcode.located.address.is.po.box	Located Address is a PO Box
resultcode.newer.record.found	Newer Record Found
resultcode.address.velocity.alert	Address Velocity Alert
resultcode.address.stability.alert	Address Stability Alert
resultcode.address.longevity.alert	Address Longevity Alert
resultcode.address.location.alert	Address Location Alert
resultcode.single.address.in.file	Single Address in File
resultcode.input.address.is.not.deliverable	Input Address Is Not Deliverable
resultcode.located.address.is.not.deliverable	Located Address Is Not Deliverable
resultcode.alternate.address.alert	Alternate Address Alert
resultcode.high.risk.address.alert	High Risk Address Alert
deliverable.input.invalid.delivery.address	Input Invalid Delivery Address
deliverable.input.deliverable.after.dropping.bldg	Input Address is Deliverable After Dropping Building Number
deliverable.input.general.delivery.address	Input Address is a General Delivery Address
deliverable.input.missing.building.number	Input Address Missing Building Number
deliverable.input.invalid.premise.number	Input Premise Number Invalid
deliverable.input.missing.box.number	Input Box Number Missing
deliverable.input.invalid.box.number	Input Box Number Invalid
deliverable.input.no.usps	Input Address is Valid but Does Not Receive USPS Mail
deliverable.input.number.needs.correction	Input Sub-Building Number Needs Correction
deliverable.input.military.address	Input Address is a Military Address
deliverable.input.business.address	Input Address is a Business Address
resultcode.warm.address.alert	Address is flagged as a warm address
resultcode.warm.address.alert.prison	Address is a correctional facility
resultcode.warm.address.alert.hospital	Address is a hospital
resultcode.warm.address.alert.mail.drop	Address is a mail drop or mail box rental
resultcode.warm.address.alert.hotel	Address is a hotel
resultcode.warm.address.alert.campground	Address is a campground
resultcode.warm.address.alert.college.university	Address is a college or university
resultcode.warm.address.alert.uspo	Address is a US Post Office
resultcode.warm.input.address.alert	Input address is flagged as a warm address
resultcode.warm.input.address.alert.prison	Input address is a correctional facility
resultcode.warm.input.address.alert.hospital	Input address is a hospital
resultcode.warm.input.address.alert.mail.drop	Input address is a mail drop or mail box rental
resultcode.warm.input.address.alert.hotel	Input address is a hotel
resultcode.warm.input.address.alert.campground	Input address is a campground
resultcode.warm.input.address.alert.college.university	Input address is a college or university
resultcode.warm.input.address.alert.uspo	Input address is a US Post Office

DOB risk codes

DOB matching alerts.

Value	Description
resultcode.yob.does.not.match	YOB Does Not Match
resultcode.mob.does.not.match	MOB Does Not Match
resultcode.yob.within.one.year	YOB Does Not Match, Within 1 Year Tolerance
resultcode.no.dob.available	DOB/YOB Not Available
resultcode.no.mob.available	MOB Not Available
resultcode.age.below.minimum	Age Below Minimum
resultcode.age.above.maximum	Age Above Maximum
resultcode.day.of.birth.does.not.match	Day of Birth Does Not Match
resultcode.day.of.birth.not.available	Day of Birth Not Available

SSN capabilities

SSN matching alerts, validation and issuance alerts

Value	Description
resultcode.ssn.does.not.match	SSN Does Not Match
resultcode.ssn.within.one.digit	SSN Does Not Match, Within Tolerance
resultcode.ssn.not.available	SSN Not Available
resultcode.ssn.not.valid	SSN Is Invalid
resultcode.input.ssn.is.itin	Input SSN is an ITIN
resultcode.located.itin	ITIN Located
resultcode.ssn.issued.prior.to.dob	SSN Issued Prior to DOB
resultcode.ssn.tied.to.multiple.names	SSN Tied to Multiple Names
ssn.does.not.match	SSN Does Not Match (legacy)
ssn.within.one.digit	SSN Does Not Match, Within Tolerance (legacy)
ssn.not.available	SSN Not Available (legacy)
ssn.not.valid	SSN Is Invalid (legacy)
input.ssn.is.itin	Input SSN is an ITIN (legacy)
located.itin	ITIN Located (legacy)
located.itinm	ITIN Located (alternate legacy alias)
ssn.issued.prior.to.dob	SSN Issued Prior to DOB (legacy)
ssn.tied.to.multiple.names	SSN Tied to Multiple Names (legacy)

Score card result

Summary results/score card results.

Value	Description
id.success	Pass
id.failure	Fail
id.partial	Partial

Match capabilities

Individual Located or Not Located

Value	Description
result.match	Match
result.no.match	No Match
result.match.restricted	Match Restricted

Age match capabilities

Individual of age, under age, can not confirm age, or match restricted.

Value	Description
resultcode.of.age	Of Age
resultcode.under.age	Under Age
resultcode.confirm.age	Can Not Confirm Age

Subject restricted capabilities

COPPA Alert.

Value	Description
resultcode.coppa.alert	COPPA Alert

Alert list capabilities

Alerts.

Value	Description
resultcode.blacklist.alert.ssn	SSN Alert
resultcode.blacklist.alert.address	Address Alert
resultcode.blacklist.alert.ip	IP Alert
resultcode.blacklist.alert.phone	Phone Alert
resultcode.blacklist.alert.email	Email Alert
resultcode.blacklist.alert.domain	Domain Alert
resultcode.blacklist.alert.document.number	Document Number Alert
resultcode.blacklist.alert.address.zip	Address Street Address and ZIP Alert
resultcode.blacklist.alert.located.ssn	Located SSN Alert

Trust USA risk capabilities

Trust USA Risk Capabilities

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

Trust USA Result Capabilities

Value	Description
pass	Pass
fail	Fail
refer	Refer

Input payload

The following is a sample payload used to submit data to the US Source 3 (including DOB) module for processing.

JSON

{
  "equalToFile": "age-request-confirmAge.json"
}

Field	Required	Description
FullName	Yes	The subject’s full name, including given and family names.
DateOfBirth	Yes	The subject’s date of birth.
CurrentAddress/lines	No	The full address as one or more free-form lines, used when structured address components are not available.
CurrentAddress/premise	Yes	The premise (building name or number) of the current address.
CurrentAddress/thoroughfare	Yes	The street or thoroughfare of the current address.
CurrentAddress/building	No	The building name or number of the current address.
CurrentAddress/subBuilding	No	The sub-building (for example, flat or unit) of the current address.
CurrentAddress/locality	No	The locality (town or city) of the current address.
CurrentAddress/administrativeArea	No	The administrative area (for example, state, province, or county) of the current address.
CurrentAddress/dependentLocality	No	The dependent locality (a smaller area within the locality) of the current address.
CurrentAddress/postalCode	Yes	The postal or ZIP code of the current address.
CurrentAddress/country	No	The country of the current address.
PreviousAddresses	No	The subject’s previous residential addresses.
MobilePhone	No	The subject’s mobile telephone number.
PersonalEmail	No	The subject’s personal email address.
SSN	No	The subject’s Social Security Number.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {
      "acceptance_result_capabilities": [],
      "address_risk_capabilities": [
        "resultcode.single.address.in.file"
      ],
      "age_restricted_capabilities": [],
      "age_result_capabilities": [
        "resultcode.confirm.age"
      ],
      "alert_list_capabilities": [],
      "dob_risk_capabilities": [
        "resultcode.no.dob.available"
      ],
      "match_result_capabilities": [],
      "name_risk_capabilities": [],
      "ssn_risk_capabilities": [],
      "subject_risk_capabilities": [],
      "trust_usa_result_capabilities": [],
      "trust_usa_risk_capabilities": []
    },
    "outcome": "Can Not Confirm Age"
  }
}