Get Person by Record
GET /mpi/v1/record/{source}/{identifier}
Given a source system and identifier, this retrieves the person’s metadata (including their Person ID) and the collection of records grouped with that individual.
Path Parameters
source
string
The system from which the record was sourced.
identifier
string
The unique identifier of the record within the source.
Response Data
id
string
The stable identifier for this person used across records (“Person ID”).
records
collection
The constituent records that represent this person.
records[n].source
string
A source system with an internal means of identifying individuals.
records[n].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.
version
integer
As records are added or removed, this version number will be incremented.
status
object
Child Fields
status.code
string
One of: Active or Retired. A record is retired when the original record has been superseded by new record(s).
status.supersededBy
string[]
If the person’s constituent records were merged into another person (or persons), this will contain a list of the IDs for the person(s).