Identity Resolution & Results

Analyzing results of identity resolution.

Identity Resolution Overview

Attest's hosted Identity Resolution API consumes data provided by the local adapter and algorithmically resolves the following scenarios

1. Matching with an identity that already exists

2. Creating a new identity if no matches within the confidence interval exist

Preparing the Export File

After the import file is fully resolved 3 CSV files will be created in the ./results directory.

Identities Created

This CSV file contains all records with the status no_match or partial_match with confidence interval of less than 90% (the lower bound of the confidence interval)

~/file_location/fusd_02_10_2020_created.csv

Identities Matched

This CSV file contains all records with the status match or partial_match with confidence interval of 92% or greater and direct matches (the higher bound of the confidence interval).

~/file_location/fusd_02_10_2020_matched.csv

Identities with Partial Match

This CSV file contains all records with the status partial_match with confidence interval of 90% or greater and 92% or lower. These identities should be manually reviewed for match results.

~/file_location/fusd_02_10_2020_partial_match.csv

Export File Contents

Each export file contains the following fields

Field	Description
referenceId string	Agency/organization-specific reference identifier, unique per individual.
rowNumber integer	Identity resolution event identifier. Unique per attempted match.
confidenceInterval float between 0 and 1	Confidence interval of identity resolution event.
universalIdentifier string (UUIDv4)	Universally unique identifier issued once per identity.
decentralizedIdentifier string	Unique public key fingerprint or cryptographic universal identifier per identity. * This field is only relevant for later use cases and can be ignored
firstName string	First name of the record being resolved.
middleName string	Middle name of the record being resolved.
lastName string	Last name of the record being resolved.
gender string	Gender of the record being resolved.
dateOfBirth YYYY-MM-DD	Date of birth of the record being resolved.
agency string	Name of the agency or organization of the record being resolved.
existingFirstName string	First name the resolution event matched against.
existingMiddleName string	Middle name the resolution event matched against.
existingLastName string	Last name the resolution event matched against.
existingGender string	Gender the resolution event matched against.
existingDateOfBirth YYYY-MM-DD	Date of birth the resolution event matched against.
existingAgency string	Name of the agency or organization the resolution event matched against.

* Indicates a field that is not required in the schema file.

Confidence Intervals

Confidence interval values are taken to the 15 decimal place for accuracy purposes.

Confidence Interval	Weighted Average
Direct Match	1
Partial Match - High Confidence	0.9200 - 0.9999
Partial Match - Requires Manual Review	0.9000 - 0.9199
Partial Match - Low Confidence	0.0001 - 0.8999