/v1/sessions/{id}/person

Get
/v1/sessions/{id}/person

Returns information objects about a person associated with the specific session ID = {id}

For matchTypes, please see the data provider's documentation [↗] for more detailed info. 

It returns the first value that is true from the following values: name_exact, aka_exact, name_fuzzy, aka_fuzzy, phonetic_name, phonetic_aka, equivalent_name, equivalent_aka, unknown. 

If appropriate, the secondary match type is returned: year_of_birth, removed_personal_title, removed_personal_suffix, removed_organisation_prefix, removed_organisation_suffix, removed_clerical_mark. 


For matchTypeDetails, please see the data provider's documentation [↗] for more detailed info. 

The matchTypeDetails field contains a detailed breakdown of why a hit occurred. For every name you matched on an entity, it will indicate how each term from your search matched it, as well other information about that name.


Note: always ensure that you use the correct API URL to send requests. See the API URL section for more info.



Security
API Key
Header parameter namex-auth-client

Your integration's API key (occasionally referred to the "Token", "API public key" or "Publishable key")

Header parameters
x-hmac-signature
stringRequired

Session id signed with the shared secret key

Path parameters
id
stringRequired

Session id

Responses
200

Person data

Expand All
object
status
string

API request status

Examplesuccess
person
object

List of objects identifying the person associated with the search term

id
string (uuid)

The unique identifier of the person

Exampleb00a203e-2524-4ded-867b-b4e281a2c96b
firstName
string | null

Person's first name

ExampleMUAMMAR GADDAFI
lastName
string | null

Person's last name

Example
idCode
string

Person's ID number

Example062.449.269-94
dateOfBirth
string (YYYY-MM-DD)

Person's date of birth

Example1942-09-22
gender
string | null

Person's gender

Valid values[ "M (male)", "F (female)", "`null` (undefined)" ]
ExampleM
nationality
string | null

Person's nationality, as ISO 3166-1 Alpha-2 country code format

ExampleLY
placeOfBirth
string | null

Person's birth place

Example`null`
citizenships
string | null Deprecated

Always returns empty array

Example
pepSanctionMatches
Array of object (PepSanctionMatch)

Array of objects identifying the PEP and Sanction values associated with the person. The array is empty if there are no hits in the database

object
provider
string

Name of the data provider that identified the PEP and Sanctions match

ExampleComply Advantage
numberOfMatches
number (integer)

The total number of PEP and Sanctions matches found

Example1
date
string

The date when the PEP and Sanctions match was identified. As Combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z

Example2018-04-18T11:02:05.261Z
matches
Array of object (PepSanctionMatchItem)

Array listing the results that match the search term

object
name
string

The name of the person matched in the PEP and Sanctions list

ExampleMouammar Mohammed Abu Minyar Kadhafi
nationality
string

The nationality of the person matched in the PEP and Sanctions list

ExampleLIBYAN
category
string

The category of the PEP and Sanctions match, SIP or PEP

Valid values[ "PEP", "SIP" ]
ExamplePEP
hits
Array of object (PepSanctionMatchesHits)

Array of objects listing results that match the search term

object
doc
object

List of attributes identifying the info in the document of the person

id
string

Document number, [a-zA-Z0-9] characters only

Example4KJL9THDX9ZNV4W
lastUpdatedUtc
string

In the format of combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z

Example2018-04-18T11:02:05.261Z
createdUtc
string

In the format of combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z

Example2018-04-18T11:02:05.261Z
fields
Array of object (PepSanctionMatchesHitsDocFields)

Array of objects describing the document fields

object
name
string

Name of the document field

ExampleOriginal Place of Birth Text
source
string

Source of the information in the document

Exampleworld-bank-star-asset-recovery-watch
value
string

Value in the document field

ExampleEuropean Union
tag
string

Tag related to the name object

Exampleorigins
locale
string

Language

ExampleEN
types
Array of string

Array of match types names as defined by the data provider

Example[ "adverse-media-v2-other-serious" ]
string
Valid values[ "adverse-media", "adverse-media-v2-cybercrime", "adverse-media-v2-financial-aml-cft", "adverse-media-v2-financial-difficulty", "adverse-media-v2-fraud-linked", "adverse-media-v2-general-aml-cft", "adverse-media-v2-narcotics-aml-cft", "adverse-media-v2-other-minor", "adverse-media-v2-other-serious", "adverse-media-v2-property", "adverse-media-v2-terrorism", "adverse-media-v2-violence-aml-cft", "adverse-media-v2-violence-non-aml-cft", "pep", "pep-class-1", "pep-class-2", "sanction", "warning" ]
name
string

Person's name on the document

ExampleMouammar Mohammed Abu Minyar Kadhafi
entityType
string

Type of the entity

Valid values[ "person" ]
Exampleperson
aka
Array of object (PepSanctionMatchesHitsDocAka)

Array of objects listing the alternative names of the person

object
name
string

Person's alternative name

ExampleMuammer al Gaddafi, োৱাম্মাৰ গাড্ডাফি
associates
Array of object (PepSanctionMatchesHitsDocAssociates)

Array of objects identifying associates of the person

object
association
string

Type of association (relationship)

Examplespouse
name
string

Associate's name

ExampleFatiha al-Nuri
sources
Array of array

Info about the information sources

Example[ "argentina-ministerio-de-relaciones-exteriores-y-culto-sanciones-de-la-onu", "belarus-state-security-agency-list-of-organizations-and-individuals-involved-in-terrorist-activities" ]
Array
keywords
Array of array Deprecated

Always returns an empty array

Example[]
Array
media
Array of object (PepSanctionMatchesHitsDocMedia)

Array of objects containing media about the person

object
date
string

In the format of combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z

Example2022-04-18T11:02:05.261Z
snippet
string

Text about the person

ExampleSang Tan Judges in the High Court in London have ruled that Saleh Ibrahim Mabrouk, a former aide of Libyan leader Colonel Muammar Gaddafi, was partly to blame for the murder of PC Yvonne Fletcher. The gunman
title
string

Title of the text about the person

Example'Justice at Last': Former Gaddafi Aide Found Liable for 1984 Police Officer Murder by UK High Court - 16.11.2021, Sputnik International
url
string

Web address to the text about the person

Examplehttps://sputniknews.com/amp/20211116/justice-at-last-former-gaddafi-aide-found-liable-for-1984-police-officer-murder-by-uk-high-court-1090775876.html
assets
Array of object (PepSanctionMatchesHitsDocAssets)

Array listing the info about media sources

object
publicURL
string

Web address

Examplehttp://complyadvantage-asset.s3.amazonaws.com/76993a49-2d1e-4397-9e35-1e20f2b7dfa8.pdf
source
string

Name of the source

Exampleworld-bank-star-asset-recovery-watch
type
string

File format

Examplepdf
sourceNotes
Array of object (PepSanctionMatchesHitsDocSourceNotes)

List of attributes identifying the information source

Example[ "argentinaMinisterioDeRelacionesExterioresYCultoSancionesDeLaOnu" ]
object
amlTypes
Array of string

List of types as defined by the data provider

Example[ "sanction" ]
string
countryCodes
Array of string

Country code, in ISO 1366-1 Alpha-2 country codes format

Example[ "AR" ]
string
listingStartedUtc
string

In the format of combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z

Example2019-09-26T00:00:00Z
name
string

Name of the info source

ExampleArgentina Ministerio de Relaciones Exteriores y Culto Sanciones de la ONU
url
string

Web address of the info source

Examplehttps://www.cancilleria.gob.ar/es/politica-exterior/seguridad-internacional/comite-de-sanciones
matchTypes
Array of string

Info about which data was matched

Example[ "name_exact", "year_of_birth" ]
string
Valid values[ "name_exact", "aka_exact", "name_fuzzy", "aka_fuzzy", "phonetic_name", "phonetic_aka", "equivalent_name", "equivalent_aka", "unknown", "year_of_birth", "removed_personal_title", "removed_personal_suffix", "removed_organisation_prefix", "removed_organisation_suffix", "removed_clerical_mark" ]
matchTypesDetails
Array of object (PepSanctionMatchesHitsMatchTypesDetails)

List of more detailed breakdown of why a match happened

object
matchTypes
string

More detailed info about why a hit occurred, for example: matching_name, sources, aml_types, name_matches, secondary_matches

Examplematching_name
type
string

Displays the type of the match_type that was matched

Exampleexact_match
matchStatus
string

Status of the match

Valid values[ "no_match", "false_positive", "potential_match", "true_positive", "unknown", "true_positive_approve", "true_positive_reject" ]
Examplepotential_match
isWhiteListed
boolean

Indicates whether an entity has been whitelisted. Availability depends on the configuration

ExampleFalse
score
number (decimal)

The request results match and ranking is computed via a score that is included as part of the metadata. It is not an absolute ranking of the document, only giving some relative indication of relevance. This decimal value comes from the data provider.

Example24.46217
400

Bad request

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleValidation failed
401

Unauthorized

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleMandatory X-AUTH-CLIENT header containing the API key is missing from the request.
404

Session not found

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleResource not found
500

Internal server error

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleSomething went wrong