Match Demographics (Blinded)

POST /mpi/v1/matchBlinded

Finds all persons and their associated records that match the provided demographics in privacy-preserving (blinded) mode. This operation is read-only, and will not create or update any records or persons within the Identity service.

To use this method you must have a local hashing service installed and use the hash demographics operation to get hashed data for the Identity API. See Privacy-Preserving (Blinded) Mode for details.

Contents

Body Data
Response Data

Body Data

data string

The B64 encoded hash provided by the local hashing service.

version integer

The version number provided by the local hashing service.

Response Data

matchingPersons collection

List of matched persons.

Child Fields

matchingPersons.id string

The stable identifier for this person used across records (“Person ID”).

matchingPersons.records collection

The constituent records that represent this person.

Child Fields

matchingPersons.records.source string

A source system with an internal means of identifying individuals.

matchingPersons.records.identifier string

The unique identifier of the record within the source. This will be stored directly in the Identity service (not hashed or encrypted), so consider what kind of identifiers are suitable to your use case.

matchingPersons.version integer

As records are added or removed, this version number will be incremented.

matchingPersons.status object

Child Fields

matchingPersons.status.code string

One of: Active or Retired. A record is retired when the original record has been superceded by new record(s).

matchingPersons.status.supercededBy collection<string

If the person’s constituent records were merged into another person, this will contain the id for that person.

If the person’s constituent records were split into two or more persons, this will contain the ids for those persons.