Argentina: Single match
Argentina: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, DNI number |
| Optional inputs | Gender, current address, landline phone, tax identification number |
Capabilities
The module returns source-count capabilities that indicate how many independent data sources confirmed each combination of identity elements, plus an age flag and an overall GBG score. This capability structure is shared across most Data Verification variants. Differences between variants are in input requirements and default outcome logic.Number of matching sources
The total number of independent data sources that returned any type of match for the subject’s submitted information.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
0 means no data sources matched any combination of the subject’s identity elements. Higher values indicate stronger verification confidence because the identity was confirmed independently across multiple sources.Name + Address matches
The number of data sources where the subject’s name and address both matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Name + DOB matches
The number of data sources where the subject’s name and date of birth both matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Name + DOB + Address matches
The number of data sources where the subject’s name, date of birth, and address all matched. This is the strongest match combination without an ID number and is typically used as the threshold for a full “Match” outcome.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
ID + Name + Address matches
The number of data sources where the subject’s national ID number, name, and address all matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
ID + Name + DOB matches
The number of data sources where the subject’s national ID number, name, and date of birth all matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
ID + Name + DOB + Address matches
The number of data sources where the subject’s national ID number, name, date of birth, and address all matched. This is the highest-confidence match combination available.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Is under 18
Indicates whether the subject is under 18 years of age based on the submitted or verified date of birth.| Value | Description |
|---|---|
true | The subject is under 18. This triggers the ALERT outcome in most variants. |
false | The subject is 18 or older, or age could not be determined. This is the default value. |
GBG score
An overall identity verification score calculated by GBG based on the strength and breadth of matches across data sources.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–1000 |
| Default | 0 |
0 indicates that no meaningful verification data was returned. This score can be used in custom evaluation rules for more granular decisioning beyond the default outcomes.Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. The journey should apply age-appropriate restrictions or route to rejection. |
Match | Name + DOB + Address ≥ 1 or ID + Name + DOB + Address ≥ 1 | The subject’s identity was confirmed by at least one data source matching the strongest element combinations. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 or ID + Name + Address ≥ 1 | Some identity elements matched but not the full combination required for a full match. The journey may route to manual review or request additional information. |
No Match | Name + Address < 1 | No data source confirmed even a basic name and address combination. |
Error | Default (no conditions matched) | An unexpected error occurred during processing. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing a successful identity match.- One source matched the full ID + Name + Address + DOB combination (
idNameAddressDob: 1), which is the strongest match available. - The GBG score is
500, indicating moderate verification confidence. - The subject is 18 or older (
isUnder18: false). - The outcome resolves to
Match.
Australia: Credit Header 1
Australia: Credit Header 1
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Supplier decision | match, mismatch, partial match, no result | The credit bureau’s overall match decision. |
| Input address quality level | 1–4 | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Supplier decision is match | Full match confirmed by the credit bureau. |
Partial Identity Match | Supplier decision is partial match | Partial match. |
Identity Mismatch | Default | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Australia: Directors
Australia: Directors
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Supplier decision is match | Identity confirmed. |
Identity Mismatch | Default | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Australia: Historical Electoral Roll
Australia: Historical Electoral Roll
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, initial match, partial match, no result | Match result for the subject’s first name. |
| Middle names match result | match, mismatch, no result, not available, initial match | Match result for middle name(s). |
| Last names match result | match, mismatch, no result | Match result for last name. |
| Overall address match result | match, mismatch, partial match, no result | Overall address match result. |
| Input address quality level | 1–4 | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name is match and last name is match and address is match | All three core elements fully matched. |
Partial Identity Match | Any of seven qualifying conditions (see below) | Partial verification with various name/address combinations. |
Identity Mismatch | Default | No verification path produced a passing result. |
any accepts every possible match result for that field.| First name | Middle names | Last name | Address |
|---|---|---|---|
mismatch | not available or mismatch | match | match |
match | not available | match | mismatch or partial match |
mismatch | match | match | any |
initial match | not available | match | any |
partial match | mismatch or not available | match | any |
initial match | initial match | match | match |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Australia: Population
Australia: Population
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, no result, initial match | Match result for first name. |
| Last names match result | match, mismatch, no result | Match result for last name. |
| Date of birth match result | match, mismatch, partial match, not available, no result | Match result for DOB. |
| Overall address match result | match, mismatch, not available, no result | Overall address match result. |
| Input address quality level | 1–4 | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name is match and last name is match and address is match and DOB is match | All four elements fully matched. |
Partial Identity Match | Name and address match but DOB is partial or mismatch, or name and DOB match but address is mismatch | Three of four elements confirmed. |
Identity Mismatch | Default | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Australia: Single match gov ID source
Australia: Single match gov ID source
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Type | Values | Description |
|---|---|---|---|
| Overall verification result | Enumset | VERIFIED, IN_PROGRESS | The overall verification status. |
| DVS sources remaining | Enumset | Various government ID source identifiers | Government ID sources that have not yet been checked. Informational only. Not used in default outcome logic. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Refer | Overall verification status includes IN_PROGRESS | Verification is not yet complete. |
Error | Default | An unexpected error occurred. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing verification still in progress.Australia: Single match standard sources (AML)
Australia: Single match standard sources (AML)
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Type | Values | Description |
|---|---|---|---|
| Overall verification result | Enumset | VERIFIED, IN_PROGRESS | The overall verification status. |
| Credit Bureau Check | Enumset | VERIFIED, AUTOFAIL, ERROR, NOT_CONTRIBUTING | Result of the credit bureau check. AUTOFAIL indicates the credit bureau data contradicted the identity. NOT_CONTRIBUTING indicates the credit bureau check did not contribute to the verification decision (e.g. no record found). Not used in default outcome logic but available for custom evaluation rules. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Pass | Overall verification status includes VERIFIED | Identity verified. |
Refer | Overall verification status includes IN_PROGRESS | Verification not yet complete. |
Error | Default | An unexpected error occurred. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity verification.Australia: Single match standard sources (non-AML)
Australia: Single match standard sources (non-AML)
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
VERIFIED, IN_PROGRESS). Default outcomes are: Pass (verified) / Refer (in progress) / Error (default).Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity verification.Australia: Single match standard sources (with additional sources) (AML)
Australia: Single match standard sources (with additional sources) (AML)
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing verification still in progress.Australia: Single match standard sources (with additional sources) (non-AML)
Australia: Single match standard sources (with additional sources) (non-AML)
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
VERIFIED, IN_PROGRESS). Default outcomes are the same: Pass / Refer / Error.Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity verification.Australia: Tenancy
Australia: Tenancy
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Supplier decision is match | Identity confirmed. |
Identity Mismatch | Default | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Brazil: Single match with CPF
Brazil: Single match with CPF
| Detail | Value |
|---|---|
| Required inputs | Full name, CPF number |
| Optional inputs | Gender, date of birth, current address, mobile phone, landline phone, identity card |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 or ID + Name + Address ≥ 1 or ID + Name + DOB ≥ 1 or ID + Name + DOB + Address ≥ 1 | Full match. At least one source confirmed a strong element combination. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Some elements matched, but not a full combination. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing a successful identity match.Brazil: Single match without CPF
Brazil: Single match without CPF
| Detail | Value |
|---|---|
| Required inputs | Full name |
| Optional inputs | Gender, date of birth, current address, mobile phone, CPF number, identity card, landline phone |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match on name, DOB, and address. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing a successful identity match.Canada: Non-Fintrac
Canada: Non-Fintrac
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, Social Insurance Number (SIN), landline phone |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Chile: Single match
Chile: Single match
| Detail | Value |
|---|---|
| Required inputs | Identity card number |
| Optional inputs | Full name, date of birth, current address |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.Colombia: Single match
Colombia: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, identity card number |
| Optional inputs | Date of birth |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a partial identity match.Denmark: Single match
Denmark: Single match
| Detail | Value |
|---|---|
| Required inputs | Determined by journey configuration |
| Optional inputs | None |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 or ID + Name + Address ≥ 1 or ID + Name + DOB + Address ≥ 1 | Full match through any strong element combination. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
France: Single match
France: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, landline phone |
| Optional inputs | Date of birth |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Germany: Schufa
Germany: Schufa
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | None |
Capabilities
The capabilities returned by this variant are grouped into name, address, and other match flags.Name match flags
Match results for the subject’s first and last names against the Schufa record.| Capability | Values | Description |
|---|---|---|
| First name matches | match, partial match, mismatch, no result, unrecognised value | Match result for the subject’s first name against the Schufa record. |
| Last names matches | match, partial match, mismatch, no result, unrecognised value | Match result for the subject’s last name. |
Address match flags
Match results for the subject’s address, both overall and at the component level.| Capability | Values | Description |
|---|---|---|
| Address match flag | match, partial match, mismatch, no result, unrecognised value | Overall address match result. |
| Thoroughfare matches | Same values | Match result for the street name. |
| Locality matches | Same values | Match result for the city or town. |
| Postal code matches | Same values | Match result for the postal code. |
Other match flags
Date of birth and the Schufa QBit (quality indicator) flag.| Capability | Values | Description |
|---|---|---|
| Date of birth matches | match, partial match, mismatch, no result, unrecognised value | Match result for the subject’s date of birth. |
| QBit present flag | Y, N, no result | Indicates whether a Schufa QBit (quality indicator) is present for the subject. A QBit confirms that Schufa holds a verified record for the subject, which increases verification confidence independently of the individual field matches. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches and address matches or partially matches and QBit is present | Full identity match. All key elements confirmed against the Schufa record, and Schufa holds a verified record for the subject. |
Partial Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches or address matches or partially matches | Name confirmed, plus either DOB or address, but not both alongside QBit. |
Identity Mismatch | Default (no conditions matched) | No verification path produced a passing result. |
Germany: Single match without Schufa
Germany: Single match without Schufa
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | Gender, mobile phone, landline phone |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Italy: Citizen Source
Italy: Citizen Source
| Detail | Value |
|---|---|
| Required inputs | Full name, current address (with country code), date of birth, phone, email |
| Optional inputs | None |
Italy: Single match (no Codice Fiscale)
Italy: Single match (no Codice Fiscale)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, identity card, landline phone, mobile phone, place of birth, gender |
Italy: Single match (with Codice Fiscale)
Italy: Single match (with Codice Fiscale)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, identity card (Codice Fiscale) |
| Optional inputs | Date of birth, landline phone, mobile phone, place of birth, gender |
Mexico: Single match
Mexico: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, tax identification number (RFC), identity card (CURP) |
| Optional inputs | Date of birth, current address, gender |
Netherlands: Citizen Source
Netherlands: Citizen Source
| Detail | Value |
|---|---|
| Required inputs | Full name, current address (with country code), date of birth, phone, email |
| Optional inputs | None |
Netherlands: Single match consumer
Netherlands: Single match consumer
| Detail | Value |
|---|---|
| Required inputs | Determined by journey configuration |
| Optional inputs | None |
Capabilities
This variant returns all the same source-count capabilities as Argentina: Single match, plus two additional boolean capabilities:Phone match
Indicates whether one or more of the subject’s submitted phone numbers matched a phone number on file in the data source.| Value | Description |
|---|---|
true | One or more phone numbers matched. |
false | No phone numbers matched, or no phone number was submitted. This is the default value. |
Email match
Indicates whether one or more of the subject’s submitted email addresses matched an email address on file in the data source.| Value | Description |
|---|---|
true | One or more email addresses matched. |
false | No email addresses matched, or no email was submitted. This is the default value. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Netherlands: Single match identity
Netherlands: Single match identity
| Detail | Value |
|---|---|
| Required inputs | Determined by journey configuration |
| Optional inputs | None |
New Zealand: Birth Certificate (mandatory GovID)
New Zealand: Birth Certificate (mandatory GovID)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth |
| Optional inputs | None |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.New Zealand: Birth Certificate (without GovID)
New Zealand: Birth Certificate (without GovID)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| First name match result | match, not available | Match result for the subject’s first name. |
| Middle names match result | match, not available, no result | Match result for the subject’s middle name(s). |
| Last names match result | match, not available | Match result for the subject’s last name. |
| Date of birth match result | match, not available | Match result for the subject’s date of birth. |
| Supplied DOB below age threshold | Y, N | Indicates whether the subject is under 18. |
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Supplied DOB below age threshold is Y | The subject is under 18. |
Identity Match | Supplier decision is match | Birth certificate details confirmed. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Citizenship Certificate (mandatory GovID)
New Zealand: Citizenship Certificate (mandatory GovID)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, identity card (GovID number) |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. No individual field match flags are returned. The supplier makes a single pass/fail determination including the GovID number. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Supplier decision is match | Citizenship certificate details confirmed including GovID. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Citizenship Certificate (without GovID)
New Zealand: Citizenship Certificate (without GovID)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth |
| Optional inputs | None |
New Zealand: Credit Header 1
New Zealand: Credit Header 1
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Full name match result | match, mismatch, no result | Match result for the subject’s full name (matched as a single combined field rather than individual name components). |
| Date of birth match result | match, mismatch, no result | Match result for the subject’s date of birth. |
| Overall address match result | match, mismatch, no result | Overall address match result. |
| Supplier decision | match, mismatch, partial match, no result | The credit bureau’s overall match decision. This capability is available for custom evaluation rules but is not used in the default outcome logic — the defaults are driven by the individual field flags instead. |
| Input address quality level | 1 (excellent), 2 (good), 3 (poor), 4 (not possible to validate) | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Full name is match and address is match and DOB is match | All three elements fully matched. |
Partial Identity Match | Full name is match and (address is match or DOB is match) | Name confirmed plus either address or DOB, but not all three. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Credit Header 2
New Zealand: Credit Header 2
Partial Identity Match outcome when the supplier returns a partial match.| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| Full name match result | match, mismatch, no result | Match result for the subject’s full name (matched as a single field rather than individual name components). |
| Date of birth match result | match, mismatch, no result | Match result for the subject’s date of birth. |
| Overall address match result | match, mismatch, no result | Overall address match result. |
| Input address quality level | 1 (excellent), 2 (good), 3 (poor), 4 (not possible to validate) | Quality of the submitted address. |
| Supplied DOB below age threshold | Y, N | Indicates whether the subject is under 18. |
| Supplier decision | match, mismatch, partial match, no result | The data source’s overall match decision. This variant uniquely supports partial match as a supplier decision value. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Supplied DOB below age threshold is Y | The subject is under 18. |
Identity Match | Supplier decision is match | Full match confirmed. |
Partial Identity Match | Supplier decision is partial match | Some identity elements matched but not all. The journey may route to manual review or request additional verification. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Credit Header 3
New Zealand: Credit Header 3
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The capabilities returned by this variant are grouped into name, address, and other match flags.Name match flags
Match results for the subject’s first, middle, and last names.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, partial match, not available, unrecognised value, no result | Match result for the subject’s first name. |
| Middle names match result | Same values | Match result for the subject’s middle name(s). |
| Last names match result | Same values | Match result for the subject’s last name. |
Address match flags
Match results for the subject’s address, both overall and at the component level.| Capability | Values | Description |
|---|---|---|
| Overall address match result | match, mismatch, partial match, not available, unrecognised value, no result | Overall address match result. |
| Premise match result | Same values | Match result for the property number. |
| Thoroughfare match result | Same values | Match result for the street name. |
| Locality match result | Same values | Match result for the city or town. |
| Dependent locality match result | match, mismatch, not available, unrecognised value, no result, partial match | Match result for the suburb or neighbourhood. |
Other match flags
Date of birth, deceased flag, and address quality.| Capability | Values | Description |
|---|---|---|
| Date of birth match result | match, mismatch, unrecognised value, no result | Match result for the subject’s date of birth. |
| Deceased flag | Y, N, no result | Indicates whether the subject is recorded as deceased. |
| Input address quality level | 1 (excellent), 2 (good), 3 (poor), 4 (not possible to validate) | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Deceased flag is Y | The subject is recorded as deceased. |
Identity Match | Last name is match and first name is match and DOB is match and address is match | All four elements fully matched. |
Partial Identity Match | Last name is match and first name is match and (DOB is match or address is match) | Name confirmed plus either DOB or address, but not all four. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Directors and Shareholders
New Zealand: Directors and Shareholders
New Zealand: Driver Licence
New Zealand: Driver Licence
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, driving licence document (licence number and version number). The type field must be set to Driving Licence; the check fails if it is missing. |
| Optional inputs | None |
Capabilities
This variant returns the same name match flags as New Zealand: Land Titles, plus:| Capability | Values | Description |
|---|---|---|
| Date of birth match result | match, not available, no result | Match result for the subject’s date of birth. |
| Driving licence number match result | match, not available, no result | Match result for the submitted licence number against the government record. |
| Document version number match result | match, not available, no result | Match result for the licence card version number. NZ driver licences have a version number that changes each time the card is renewed or replaced. |
| Supplied DOB below age threshold | Y, N | Indicates whether the subject is under 18. |
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Supplied DOB below age threshold is Y | The subject is under 18. |
Identity Match | Supplier decision is match | The data source confirmed the subject’s identity. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Field descriptions
Field descriptions
| Field | Required | Description |
|---|---|---|
identity.firstName | Yes | First name of the subject. |
identity.middleNames | No | Array containing middle name(s) of the subject. |
identity.lastNames | Yes | Array containing the last name(s) of the subject. |
identity.dateOfBirth | Yes | Date of birth in YYYY-MM-DD format. |
identity.currentAddress | No | Current address of the subject, broken down into premise, thoroughfare, locality, postalCode, and country (ISO 3166-1 alpha-3). |
documents[].type | Yes | Document type. Must be set to "Driving Licence"; the check fails if this field is missing. |
documents[].number | Yes | Driver licence number. Must match the pattern ^[A-Za-z]{1,2}[0-9]{6}$ (1–2 letters followed by 6 digits). Example: "AB123456". |
documents[].cardNumber | Yes | Card version number printed on the driver licence. Must match the pattern ^[0-9]{3}$ (exactly 3 digits). Example: "123". |
Sample response
The following is a sample response for a successful identity match.New Zealand: Land Titles
New Zealand: Land Titles
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | None |
Capabilities
The capabilities returned by this variant are grouped into name match flags, an address match flag, address quality, and supplier decision.Name match flags
Match results for the subject’s first, middle, and last names against the Land Titles record.| Capability | Values | Description |
|---|---|---|
| First name match result | match, not available, no result | Match result for the subject’s first name against the Land Titles record. |
| Middle names match result | match, not available, no result | Match result for the subject’s middle name(s). |
| Last names match result | match, not available, no result | Match result for the subject’s last name. |
Address match flag
Overall address match result.| Capability | Values | Description |
|---|---|---|
| Overall address match result | match, not available, no result | Overall address match result. |
Address quality
Indicator of how well the submitted address could be validated.| Capability | Values | Description |
|---|---|---|
| Input address quality level | 1 (excellent), 2 (good), 3 (poor), 4 (not possible to validate) | A broad indicator of the quality of the submitted address. A value of 4 (the default) indicates the address could not be validated. This capability can be used in custom evaluation rules to filter out results where the address input was too poor to produce a meaningful match. |
Supplier decision
Overall match decision returned by the data source. This is the primary capability used in the default outcome logic.| Capability | Values | Description |
|---|---|---|
| Supplier decision | match, mismatch, unrecognised value, not available, no result | The data source’s overall match decision. This is the primary capability used in the default outcome logic. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | Supplier decision is match | The data source confirmed the subject’s identity. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
New Zealand: Passport
New Zealand: Passport
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth, passport document (passport number and expiry date). The type field must be set to Passport; the check fails if it is missing. |
| Optional inputs | None |
Capabilities
This variant returns the same name and DOB match flags as New Zealand: Birth Certificate (without GovID), plus:| Capability | Values | Description |
|---|---|---|
| Passport number match result | match, not available, no result | Match result for the submitted passport number. |
| Passport expiry match result | match, not available, no result | Match result for the passport expiry date. A match confirms the submitted expiry date matches the record, which also implicitly confirms the passport has not been replaced. |
| Supplied DOB below age threshold | Y, N | Indicates whether the subject is under 18. |
| Supplier decision | match, mismatch, no result | The data source’s overall match decision. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Supplied DOB below age threshold is Y | The subject is under 18. |
Identity Match | Supplier decision is match | Passport details confirmed. |
Identity Mismatch | Default (no conditions matched) | The subject could not be verified. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Field descriptions
Field descriptions
| Field | Required | Description |
|---|---|---|
identity.firstName | Yes | First name of the subject. |
identity.middleNames | No | Array containing middle name(s) of the subject. |
identity.lastNames | Yes | Array containing the last name(s) of the subject. |
identity.dateOfBirth | Yes | Date of birth in YYYY-MM-DD format. |
documents[].type | Yes | Document type. Must be set to "Passport"; the check fails if this field is missing. |
documents[].number | Yes | Passport number. Must match the pattern ^[A-Za-z]{1,2}[0-9]{6}$ (1–2 letters followed by 6 digits). Example: "AB123456". |
documents[].expiryDate | Yes | Passport expiry date in YYYY-MM-DD format. Example: "2029-03-14". |
Sample response
The following is a sample response for a successful identity match.New Zealand: Single match gov ID source
New Zealand: Single match gov ID source
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Type | Values | Description |
|---|---|---|---|
| Overall verification result | Enumset | VERIFIED, IN_PROGRESS | The overall verification status. VERIFIED indicates the verification rule has been met across the required sources. IN_PROGRESS indicates verification is not yet complete. Additional sources may still need to be checked. |
| DVS sources remaining | Enumset | nztadriverslicence, nzpassport, nzcitizenship, nzbirthcertificate | The government ID sources (Document Verification Service sources) that have not yet been checked. This capability is informational and is not used in the default outcome logic. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Refer | Overall verification status includes IN_PROGRESS | Verification is not yet complete. The journey should route to additional verification steps or manual review. |
Error | Default | An unexpected error occurred. |
New Zealand: Single match standard sources
New Zealand: Single match standard sources
| Detail | Value |
|---|---|
| Required inputs | Determined by the registration process |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Type | Values | Description |
|---|---|---|---|
| Overall verification result | Enumset | VERIFIED, IN_PROGRESS | The overall verification status. VERIFIED indicates at least one standard source confirmed the subject’s identity. IN_PROGRESS indicates verification is not yet complete. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Pass | Overall verification status includes VERIFIED | Identity verified against at least one standard source. |
Refer | Overall verification status includes IN_PROGRESS | Verification is not yet complete. |
Error | Default | An unexpected error occurred. |
New Zealand: Tenancy
New Zealand: Tenancy
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, date of birth |
| Optional inputs | None |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, no result | Match result for first name. |
| Last names match result | match, mismatch, no result | Match result for last name. |
| Date of birth match result | match, mismatch, no result | Match result for DOB. |
| Overall address match result | match, mismatch, no result | Overall address match result. |
| Input address quality level | 1–4 | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name is match and last name is match and DOB is match and address is match | All four elements fully matched. |
Partial Identity Match | First name is match and last name is match and (DOB is match or address is match) | Name confirmed plus either DOB or address, but not all four elements. |
Identity Mismatch | Default | The subject could not be verified. |
Peru: Single match
Peru: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, identity card (DNI) |
| Optional inputs | Current address, mobile phone, work email, personal email, landline phone |
Capabilities
This variant returns all the same source-count capabilities as Argentina: Single match, plus:ID + Name matches
The number of data sources where the subject’s national ID number and name matched, without requiring address or DOB.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Phone match
| Value | Description |
|---|---|
true | One or more phone numbers matched. |
false | No phone numbers matched. This is the default value. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 or ID + Name + Address ≥ 1 or ID + Name + DOB ≥ 1 or ID + Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 or ID + Name ≥ 1 | Partial match. Note that ID + Name (without address or DOB) qualifies as a partial match for Peru. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Poland: Single match
Poland: Single match
| Detail | Value |
|---|---|
| Required inputs | Determined by journey configuration |
| Optional inputs | None |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Poland: Single match population
Poland: Single match population
South Africa: Single match
South Africa: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, identity card number |
| Optional inputs | Current address, date of birth, landline phone, mobile phone, gender |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing a successful identity match.- Two sources matched the full ID + Name + Address + DOB combination, shown by
idNameAddressDob: 2, which is the strongest match available. - The GBG score is
745, indicating high verification confidence. - The subject is 18 or older, shown by
isUnder18: false. - The outcome resolves to
Match.
Spain: Citizen Source
Spain: Citizen Source
| Detail | Value |
|---|---|
| Required inputs | Full name, current address (with country code), date of birth, phone, email |
| Optional inputs | None |
Capabilities
The capabilities returned by this variant are grouped into name, address, and other match flags.Name match flags
Match results for the subject’s first name, last name, and initial.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, partial match, not available, unrecognised value, no result | Match result for first name. |
| Last names match result | Same values | Match result for last name. |
| Initial matches | match, mismatch, not available, unrecognised value, no result | Match result for the subject’s initial. |
Address match flags
Match results for the subject’s address, both overall and at the component level.| Capability | Values | Description |
|---|---|---|
| Overall address match result | match, mismatch, partial match, not available, unrecognised value, no result | Overall address match result. |
| Address line 1 match flag | match, mismatch, not available, unrecognised value, no result | Match result for the first line of the address. |
| Postal code match result | Full value set (including partial match) | Match result for postal code. |
| Locality match result | Full value set | Match result for city or town. |
| Administrative area match result | Full value set | Match result for province or autonomous community. |
Other match flags
Date of birth, phone, email, and address quality.| Capability | Values | Description |
|---|---|---|
| Date of birth match result | Full value set (including partial match) | Match result for DOB. |
| Phone match result | match, mismatch, not available, unrecognised value, no result | Match result for phone number. |
| Email match result | Same values | Match result for email address. |
| Input address quality level | 1–4 | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches and address matches or partially matches | All four core elements confirmed. |
Partial Identity Match | First name matches or partially matches and last name matches or partially matches and (DOB matches or partially matches or address matches or partially matches) | Name confirmed plus either DOB or address. |
Could Not Locate | First name is not available and last name is not available | The subject could not be found in the data source. |
Identity Mismatch | Default | No verification path produced a passing result. |
Spain: Single match
Spain: Single match
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, identity card (DNI/NIE), landline phone |
Sweden: Single match personal ID
Sweden: Single match personal ID
| Detail | Value |
|---|---|
| Required inputs | Determined by journey configuration |
| Optional inputs | None |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
Sweden: Single match population
Sweden: Single match population
UK: Credit Bureau 1
UK: Credit Bureau 1
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, gender |
Capabilities
This variant returns several count-based capabilities and an under-18 flag, described below.Count of matches against name and address
The number of data sources where the subject’s name and address matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Count of matches against name and date of birth
The number of data sources where the subject’s name and date of birth matched.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Count of matches against name, address and date of birth
The number of data sources where all three elements (name, address, and date of birth) matched. This is the strongest match combination for this variant and is the threshold for theIdentity Match outcome.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Total sources with more than one field match
The total number of data sources that matched on more than one field (any combination). This serves as the threshold for thePartial Identity Match outcome. It captures cases where some elements matched but not the full name + address + DOB combination.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Total sources where name and address match
An aggregate count of sources confirming the name and address combination.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Total sources where name and date of birth match
An aggregate count of sources confirming the name and date of birth combination.| Detail | Description |
|---|---|
| Type | Integer |
| Range | 0–5 |
| Default | 0 |
Is under 18
| Value | Description |
|---|---|
true | The subject is under 18. |
false | The subject is 18 or older. This is the default value. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Is under 18 is true | The subject is under 18. |
Identity Match | Name + address + DOB match count ≥ 1 | All three core elements confirmed by at least one source. |
Partial Identity Match | Total any match count ≥ 1 | At least one source matched on more than one field, but not the full combination. |
Identity Mismatch | Default (no conditions matched) | No verification path produced a passing result. |
Configuration
You can configure how matches are counted for this variant in the module settings. These settings control which match types are included in the count totals.| Setting | Description |
|---|---|
| Include ER into count | Include electoral roll matches in the count totals. |
| Include alias forename into count | Include alias (known-as) name matches in the count totals. |
| Include partial forename into count | Include partial first name matches in the count totals. |
| Include partial surname into count | Include partial last name matches in the count totals. |
| Include partial address into count | Include partial address matches in the count totals. |
Understanding specific counts vs. total counts
The capability counters operate at two levels:- Specific counts (e.g.
nameAddressMatchCount) only increment when exactly the listed fields matched, with no additional fields. - Total counts (e.g.
totalNameAndAddressMatchCount) increment when those fields matched, regardless of whether additional fields also matched.
| Counter | Value | Explanation |
|---|---|---|
nameAddressDobMatchCount | 3 | Only the exact three-field matches |
nameAddressMatchCount | 1 | Only the exact two-field match |
totalNameAndAddressMatchCount | 4 | All sources where name and address matched, including the 3 that also matched DOB |
totalAnyMatchCount | 4 | All sources with more than one field match |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing a successful identity match against multiple sources.- 2 tradeline sources matched on name, address, and DOB (
nameAddressDobMatchCount: 2) - 1 electoral roll source matched on name and address only (
nameAddressMatchCount: 1) - 0 sources matched on name and DOB exclusively (
nameDobMatchCount: 0) - 3 total sources had more than one field match (
totalAnyMatchCount: 3) - The
innerarray provides per-source detail with individual match flags for each source
UK: Credit Bureau 2
UK: Credit Bureau 2
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, gender |
UK: Credit Bureau 3
UK: Credit Bureau 3
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, gender |
UK: Edited and Historical Electoral Roll
UK: Edited and Historical Electoral Roll
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | None |
Capabilities
The capabilities returned by this variant are grouped into name and other match flags.Name match flags
Match results for the subject’s first, middle, and last names.| Capability | Values | Description |
|---|---|---|
| First name matches | match, initial match, alias match, partial match, mismatch, not available, no result, unrecognised value | Match result for the subject’s first name. An initial match indicates only the initial letter matched. An alias match indicates the name matched a known alias. |
| Middle names matches | match, initial match, partial match, mismatch, not available, no result, unrecognised value | Match result for the subject’s middle name(s). |
| Last names matches | match, partial match, mismatch, not available, no result, unrecognised value | Match result for the subject’s last name. |
Other match flags
Address, date of birth, and under-18 flag.| Capability | Values | Description |
|---|---|---|
| Address matches | match, partial match, mismatch, not available, no result, unrecognised value | Overall address match result. |
| Date of birth matches | match, partial match, mismatch, not available, no result, unrecognised value | Match result for the subject’s date of birth. |
| Under 18 flag | Y, N, no result | Indicates whether the subject is under 18. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Under 18 is Y | The subject is under 18. |
Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches and address matches or partially matches | All four key elements confirmed. |
Partial Identity Match | First name matches or partially matches and last name matches or partially matches and (DOB matches or partially matches or address matches or partially matches) | Name confirmed, plus either DOB or address (but not both). |
Could Not Locate | First name is not available and last name is not available | The subject could not be found. No match was attempted because no record was located. |
Identity Mismatch | Default (no conditions matched) | A record was located but key elements did not match. |
UK: National ID Register
UK: National ID Register
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | National Insurance Number |
Capabilities
The name, address, date of birth, and under 18 match flags are the same as UK: Edited and Historical Electoral Roll, with one difference: first name matches also acceptsalias match as a qualifying value for the Identity Match outcome (not just match and partial match).This variant adds two phone match flags.Phone match flags
Match results for the subject’s landline and mobile phone numbers.| Capability | Values | Description |
|---|---|---|
| Landline phone match | match, mismatch, not available, unrecognised value, no result | Match result for the subject’s landline phone number. |
| Mobile phone match | match, mismatch, not available, unrecognised value, no result | Match result for the subject’s mobile phone number. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Alert | Under 18 is Y | The subject is under 18. |
Identity Match | First name matches, partially matches, or alias matches and last name matches or partially matches and DOB matches or partially matches and address matches or partially matches | All four key elements confirmed. Note that alias match qualifies for full match here, unlike the Electoral Roll variant. |
Partial Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches or address matches or partially matches | Name confirmed, plus either DOB or address. |
Could Not Locate | First name is not available and last name is not available | The subject could not be found on the register. |
Identity Mismatch | Default (no conditions matched) | A record was located but key elements did not match. |
UK: Single match all sources
UK: Single match all sources
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | Gender, mobile phone, National Insurance Number, mother’s maiden name, landline phone |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
ALERT | Is under 18 is true | The subject is under 18. |
Match | Name + DOB + Address ≥ 1 | Full match. |
Partial Match | Name + Address ≥ 1 or Name + DOB ≥ 1 | Partial match. |
No Match | Name + Address < 1 | No match. |
Error | Default | An unexpected error occurred. |
UK: Single match Credit Bureau 1 (Legacy)
UK: Single match Credit Bureau 1 (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, gender |
UK: Single match Credit Bureau 2 (Legacy)
UK: Single match Credit Bureau 2 (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth |
UK: Single match Credit Bureau 3 (Legacy)
UK: Single match Credit Bureau 3 (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | None |
UK: Single match super bureau
UK: Single match super bureau
UK: Mortality
UK: Mortality
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, previous addresses |
Capabilities
| Capability | Values | Description |
|---|---|---|
| Is deceased | Y, N, no result | Whether the subject is recorded as deceased. |
Default outcomes
| Outcome | Condition | Description |
|---|---|---|
Deceased | Is deceased is Y | The subject is recorded as deceased. |
Not Deceased | Is deceased is N | The subject is not recorded as deceased. |
No Result | Default (no conditions matched) | No mortality data was returned for the subject. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response showing that the subject is not recorded as deceased.- The mortality data source returned
deceasedFlag: "N", indicating the subject is not recorded as deceased. - The
innerarray shows the data source consulted:population. - The outcome resolves to
Not Deceased.
US: Credit Bureau
US: Credit Bureau
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, phone, SSN |
Capabilities
The table below lists the capabilities returned by this variant.| Capability | Values | Description |
|---|---|---|
| First name match result | match, mismatch, partial match, not available, unrecognised value, no result | Match result for the subject’s first name. |
| Middle names match result | Same values | Match result for middle name(s). |
| Last names match result | Same values | Match result for last name. |
| Date of birth match result | Same values | Match result for date of birth. |
| Overall address match result | Same values | Overall address match result. |
| SSN match result | Same values | Match result for the Social Security Number. |
| Phone match result | match, mismatch, not available, unrecognised value, no result | Match result for the submitted phone number. |
| Input address quality level | 1 (excellent), 2 (good), 3 (poor), 4 (not possible to validate) | Quality of the submitted address. |
Default outcomes
The table below lists the default outcomes for this variant.| Outcome | Condition | Description |
|---|---|---|
Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches and address matches or partially matches | All four core elements confirmed. |
Partial Identity Match | First name matches or partially matches and last name matches or partially matches and DOB matches or partially matches or address matches or partially matches or SSN matches | Name confirmed plus at least one of DOB, address, or SSN. |
Could Not Locate | First name is not available and last name is not available | The subject could not be found. |
Identity Mismatch | Default | No verification path produced a passing result. |
Input payload
The following is a sample payload used to submit identity data to the Data Verification module for processing.Sample response
The following is a sample response for a successful identity match.US: Credit Bureau 1
US: Credit Bureau 1
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, previous addresses, mobile phone, personal email, SSN |
Capabilities
This variant returns field-level match flags grouped into name, address, and other categories, alongside the full enumset risk code suite.Name match flags
Match results for the subject’s first and last names.| Capability | Values | Description |
|---|---|---|
| First name matches | match, partial match, mismatch, not available, no result | Match result for the subject’s first name. |
| Last names matches | Same values | Match result for the subject’s last name. |
Address match flags
Match results for the subject’s address, both overall and at the component level.| Capability | Values | Description |
|---|---|---|
| Address matches | match, partial match, mismatch, not available, no result | Overall address match result. |
| Thoroughfare matches | Same values | Match result for the street name. |
| Locality matches | Same values | Match result for the city or town. |
| Postal code matches | Same values | Match result for the postal/ZIP code. |
| Building matches | Same values | Match result for the building or house number. |
| Administrative area matches | Same values | Match result for the state. |
Other match flags
Date of birth and Social Security Number.| Capability | Values | Description |
|---|---|---|
| Date of birth matches | match, month level match, year level match, partial match, mismatch, not available, no result | Match result for DOB. month level match indicates the month and year matched but the day did not. year level match indicates only the year matched. |
| Social insurance number matches | match, partial match, mismatch, not available, no result | Match result for the SSN. |
Enumset risk code capabilities
This variant also returns all enumset risk code categories documented under US: Source 1 (Legacy): subject risk codes, address risk codes (including warm address alerts), DOB risk codes, SSN risk codes, acceptance result, match result, COPPA alert, alert list, Trust USA risk codes, and Trust USA result.Default outcomes
The outcome logic combines the match result and acceptance result capabilities. This is the same as US: Source 1 (Legacy). The individual field-match flags are not used in the default outcome logic. They are available for custom evaluation rules.| Outcome | Condition | Description |
|---|---|---|
Match | Match result includes result.match and acceptance result includes id.success | Subject located and identity check passed. |
Match Restricted | Match result includes result.match.restricted | Subject located but match is restricted (for example, COPPA, deceased). |
No Match | Match result includes result.match and acceptance result includes id.failure | Subject located but identity check failed. |
Could Not Locate | Match result includes result.no.match and acceptance result includes id.failure | Subject could not be found in data sources. |
Partial Match | Match result includes result.match and acceptance result includes id.partial | Partial verification — some elements confirmed but not all. |
Error | Default (no conditions matched) | An unexpected error occurred. |
US: Credit Bureau 2
US: Credit Bureau 2
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, previous addresses, mobile phone, personal email, SSN |
US: Source 1 (Legacy)
US: Source 1 (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address |
| Optional inputs | Date of birth, previous addresses, mobile phone, personal email, SSN |
Capabilities
All US Source 1 variants share the same capability set. The capabilities are enumset types. Each can contain zero or more result codes simultaneously.Subject risk codes
Flags indicating issues with the subject record itself.| Code | Description |
|---|---|
| Subject is Deceased | The subject is recorded as deceased. |
| Multiple Records Found | More than one record matched the submitted identity elements. |
| Thin File | The subject has a limited data history, which reduces verification confidence. |
| Data Strength Alert | The data available for the subject is insufficient for a confident match. |
Name risk codes
| Code | Description |
|---|---|
| Last Name Does Not Match | The submitted last name did not match the located record. |
| First Name Does Not Match | The submitted first name did not match the located record. |
Address risk codes
This is the largest capability category, covering match failures, deliverability issues, behavioural signals, and warm address alerts.- Match codes: Address Does Not Match, Street Number Does Not Match, Street Name Does Not Match, Address Does Not Match Within Tolerance, City Does Not Match, State Does Not Match, Zip Code Does Not Match.
- Deliverability signals: Input Address Is Not Deliverable, Located Address Is Not Deliverable, Input Invalid Delivery Address, Input Address is Deliverable After Dropping Building Number, Input Address is a General Delivery Address, Input Address Missing Building Number, Input Premise Number Invalid, Input Box Number Missing, Input Box Number Invalid, Input Address is Valid but Does Not Receive USPS Mail, Input Sub-Building Number Needs Correction.
- Behaviour signals: Newer Record Found (a more recent address exists), Address Velocity Alert (frequent address changes), Address Stability Alert, Address Longevity Alert (short time at address), Address Location Alert, Single Address in File, Alternate Address Alert.
- Address type signals: Input Address is a PO Box, Located Address is a PO Box, Input Address is a Military Address, Input Address is a Business Address, High Risk Address Alert.
- Warm address alerts: These flag addresses associated with specific institutional locations. Each alert exists in two forms: one for the located address and one for the input address. Location types include: Prison, Hospital, Mail Drop, Hotel, Campground, College/University, and USPO (US Post Office).
DOB risk codes
| Code | Description |
|---|---|
| YOB Does Not Match | Year of birth did not match. |
| MOB Does Not Match | Month of birth did not match. |
| YOB Does Not Match, Within 1 Year Tolerance | Year of birth is off by one year. |
| DOB or YOB Not Available | No date of birth or year of birth data is available. |
| MOB Not Available | No month of birth data is available. |
| Age Below Minimum | The subject’s age is below the configured minimum. |
| Age Above Maximum | The subject’s age exceeds the configured maximum. |
| Day of Birth Does Not Match | The day component of the date of birth did not match. |
| Day of Birth Not Available | No day of birth data is available. |
SSN risk codes
Codes for SSN matching, validation, and issuance anomalies. Includes both current and legacy code formats.| Code | Description |
|---|---|
| SSN Does Not Match | The submitted SSN did not match. |
| SSN Does Not Match, Within Tolerance | The SSN is off by one digit. |
| SSN Not Available | No SSN data is available for the subject. |
| SSN Is Invalid | The submitted SSN is not a valid format. |
| Input SSN is an ITIN | The submitted number is an Individual Taxpayer Identification Number, not an SSN. |
| ITIN Located | An ITIN was found associated with the subject. |
| SSN Issued Prior to DOB | The SSN was issued before the subject’s recorded date of birth. |
| SSN Tied to Multiple Names | The SSN is associated with more than one identity. |
Acceptance result (score card)
| Code | Description |
|---|---|
id.success (Pass) | The identity check passed the configured score card rules. |
id.failure (Fail) | The identity check failed. |
id.partial (Partial) | The identity check partially passed. |
Match result
| Code | Description |
|---|---|
result.match (Match) | The subject was located in the data sources. |
result.no.match (No Match) | The subject could not be located. |
result.match.restricted (Match Restricted) | The subject was located but the match is restricted (e.g. due to a COPPA alert or deceased status). |
COPPA alert
| Code | Description |
|---|---|
| COPPA Alert | The subject appears to be under 13 years of age, triggering the Children’s Online Privacy Protection Act restriction. |
Alert list
Flags for subjects or elements that appear on configured alert lists.| Code | Description |
|---|---|
| SSN Alert | The SSN appears on an alert list. |
| Address Alert | The address appears on an alert list. |
| IP Alert | The IP address appears on an alert list. |
| Phone Alert | The phone number appears on an alert list. |
| Email Alert | The email address appears on an alert list. |
| Domain Alert | The email domain appears on an alert list. |
| Document Number Alert | A document number appears on an alert list. |
| Address Street Address and ZIP Alert | The street address and ZIP combination appears on an alert list. |
| Located SSN Alert | The SSN found in the located record appears on an alert list. |
Trust USA risk codes
An extensive set of element-pair risk codes that indicate which specific combinations of input (I-prefix) and located (L-prefix) identity elements were flagged. These codes use short identifiers (e.g.IADDR for input street address, LSSN9 for located SSN9). The full set includes combinations of name, address, SSN, phone, email, IP address, and document elements. Also includes overall pass, fail, and refer result codes.Trust USA result
| Code | Description |
|---|---|
pass | The Trust USA check passed. |
fail | The Trust USA check failed. |
refer | The Trust USA check requires manual review. |
Default outcomes
The outcome logic combines the match result and acceptance result capabilities.| Outcome | Condition | Description |
|---|---|---|
Match | Match result includes result.match and acceptance result includes id.success | Subject located and identity check passed. |
Match Restricted | Match result includes result.match.restricted | Subject located but match is restricted (e.g. COPPA, deceased). |
No Match | Match result includes result.match and acceptance result includes id.failure | Subject located but identity check failed. |
Could Not Locate | Match result includes result.no.match and acceptance result includes id.failure | Subject could not be found in data sources. |
Partial Match | Match result includes result.match or acceptance result includes id.partial | Partial verification. Some elements confirmed, but not all. |
Error | Default | An unexpected error occurred. |
US: Source 1 (including DOB and SSN) (Legacy)
US: Source 1 (including DOB and SSN) (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address, SSN |
| Optional inputs | Previous addresses, mobile phone, personal email |
US: Source 1 (including DOB) (Legacy)
US: Source 1 (including DOB) (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, date of birth, current address |
| Optional inputs | Previous addresses, mobile phone, personal email, SSN |
US: Source 1 (including SSN) (Legacy)
US: Source 1 (including SSN) (Legacy)
| Detail | Value |
|---|---|
| Required inputs | Full name, current address, SSN |
| Optional inputs | Previous addresses, mobile phone, personal email, date of birth |