Validation Services
Screen an individual
In this tutorial, you'll understand what information is required to screen an individual's name against Sanctions and or Politically Exposed Persons (PEP) lists.
Before you begin
To retrieve the status of a Validation Services request, you will need the following:
- A registered and fully onboarded Developer Account on the J.P. Morgan Payments Developer Portal.
- An active profile that provides you with the credentials to make a request.
Screen an individual
Screens details provided about individual entity against Sanctions and/or PEP lists and returns whether or not a potential match was found for the individual. To initiate screening, call a POST request to the /v2/validations/entities endpoint. Below are some examples of screening:
Sanctions screening only, No matches Found
Request JSON
Json
[{
"requestId": "individualSanctionsClear",
"entity": {
"individual": {
"firstName": "RAJ",
"lastName": "ROB",
"nameSuffix": "Jr",
"associatedCountries": ["US"],
"postalAddress": {
"addressLine": [
"10 S Dearborn"
],
"townName": "Chicago",
"countrySubDvsn": "IL",
"country": "US",
"postalCode": "60606"
},
"identification": [{
"idType": "PASSPORT",
"id": "E92821"
}
],
"gender": "M",
"dateOfBirth": "19900318"
}
}
}
]CLEAR Response
Response JSON
Json
[
{
"requestId": "individualSanctionsClear",
"responses": [
{
"codes": {
"individualScreening": {
"code": 4509,
"message": "Clear"
}
},
"provider": "JPMC_SCREENING",
"details": {
"providerResponse": {
"realTimeResponseSchemas": [
{
"searchResponse": [
{
"searchConfigId": "EVS-SANCTIONS",
"result": {
"recordState": {
"state": "CLEAR"
}
},
"listName": {
"United States of America (the)": {
"BXA": "USA - BXA - Bureau Ind and Sec Denied Persons List",
"BISN": "BUREAU OF INTERNATIONAL SECURITY & NONPROLIFERATION SANCTIONS",
"CAPTA-561": "USA - CAPTA-561- OFAC CAPTA List",
"FSEL": "FOREIGN SANCTIONS EVADERS LIST",
"BXAENT": "USA - BXAENT - Bureau of Industry and Security - Entity List",
"BXAMEU": "USA - BXAMEU - Bureau of Industry and Security - Military End-User List",
"BXAUNVER": "USA - BXAUNVER - Bureau Industry and Security - Unverified List",
"NS-CAATSA-RUSSIA": "USA RUSSIA LIST",
"NS-IRAN": "USA-NS-IRAN – NON SDN List Iran (EO13599)",
"NS-PEESA": "USA - NS-PEESA - Protecting Europe's Energy Security Act",
"NS-PLC": "OFAC - PALESTINIAN LEGISLATIVE COUNCIL LIST",
"OFAC": "OFAC SDN LIST (OFFICE OF FOREIGN ASSETS CONTROL)",
"OFAC_NONSDN": "USA - OFAC-NONSDN - OFAC NON SDN List",
"SDTEL": "US STATE DEPARTMENT - TERRORIST EXCLUSION LIST",
"USCRAL": "USA - USCRAL - Cuba Restricted Accommodation List",
"USCRL": "USA - USCRL - Cuba Restricted list",
"USTREAS.311": "US TREASURY - US PATRIOT ACT SECTION 311",
"UN": "United Nations Sanctions"
}
}
},
]
}
]
}
}
}
]
}
]Sanctions screening only, Matches Found
Request JSON
Json
[{
"requestId": "individualSanctionsHit",
"entity": {
"individual": {
"firstName": "QUEEN",
"lastName": "KING",
"associatedCountries": ["US"],
"postalAddress": {
"addressLine": [
"1234 Main St"
],
"townName": "Tokyo",
"countrySubDvsn": "JA",
"country": "SA",
"postalCode": "60606"
},
"identification": [{
"idType": "TIN",
"id": "F349952"
}
],
"dateOfBirth": "19850131"
}
}
}
]POTENTIAL-HIT response
Json
[
{
"requestId": "individualSanctionsHit",
"responses": [
{
"codes": {
"individualScreening": {
"code": 4609,
"message": "Potential Hit"
}
},
"provider": "JPMC_SCREENING",
"details": {
"providerResponse": {
"realTimeResponseSchemas": [
{
"searchResponse": [
{
"searchConfigId": "EVS-SANCTIONS",
"listName": {
"United States of America (the)": {
"BXAMEU": "USA - BXAMEU - Bureau of Industry and Security - Military End-User List",
"FSEL": "FOREIGN SANCTIONS EVADERS LIST",
"NS-PEESA": "USA - NS-PEESA - Protecting Europe´s Energy Security Act",
"OFAC-NONSDN": "USA - OFAC-NONSDN - OFAC NON SDN List",
"UN": "UNITED NATIONS SANCTIONS",
"SDTEL": "US STATE DEPARTMENT - TERRORIST EXCLUSION LIST",
"NS-PLC": "OFAC - PALESTINIAN LEGISLATIVE COUNCIL LIST",
"OFAC": "OFAC SDN LIST (OFFICE OF FOREIGN ASSETS CONTROL)"
},
"Saudi Arabia": {
"SAMOI": "SAUDI MINISTRY OF INTERIOR MOST WANTED",
"UN": "UNITED NATIONS SANCTIONS",
"EU": "EUROPEAN UNION SANCTIONS"
}
},
"matches": {
"match": [
{
"comments": " Keywords: OFAC~SDNTK || Date Entered: 2008/05/30 | Date Updated: 2023/03/14 | Further Information: [USA SANCTIONS - OFAC] SDN Ref No 10898 - SDNTK (Specially Designated Narcotics Trafficker Kingpin) (May 2008 - addition). PRIMARY NAME: QUEEN, KING. (a.k.a. KING, Asad; a.k.a. KING, Haji QUEEN; a.k.a. KING, QUEEN; a.k.a. QUENHASNI, QU KING; a.k.a. MOHAMMADHASNI, Haji Asad KING; a.k.a. QUEENHASNI, Asad KING; a.k.a. QUEENHASNI, Asad KING; a.k.a. ZARKARI, Asad KING; a.k.a. \"ASAD, Haji\"; a.k.a. \"HAJI ABDULLAH\"), Kabul, Afghanistan; Karachi, Pakistan; Nimroz, Afghanistan; Basalani, Afghanistan; Balochistan, Pakistan; Dubai, United Arab Emirates; DOB 01 Jan 1955; POB Nimroz, Afghanistan; citizen Afghanistan; Passport XXXXXX (Afghanistan) [BIOGRAPHY] To be determined. [IDENTIFICATION] To be determined. [REPORTS] Oct 2021 - no further information reported.",
"matchingItems": {
"matchingItem": [
{
"itemMatchType": "NAME",
"inputValue": "QUEEN KING",
"listValue": "QUEEN KING"
}
]
}
},
{
"comments": " Companies: | AL QA'IDA, 7246 || Associations: | AL ZAWAHIRI, DR AYMAN, 11446 | ABDULLAH, ABDULLAH AHMED, 13676 | AL-LIBY, ANAS, 13679 | ATWAH, MUHSIN MUSA MATWALLI, 13681 | GHAILANI, AHMED KHALFAN, 13683 | QUEEN, FAZUL ABDULLAH, 13684 | MSALAM, FAHID QUEEN ALLY, 13685 | SWEDAN, SHEIKH AHMED SALIM, 13686 | BIN LADIN, USAMA BIN QUEEN BIN AWAD, 3969 | AL-MASRI, ABU HAFS, 7242 || Keywords: BGDANS~FBI~HKMA~IMOD~KOFIU~KRMSF~OFAC~RSA-AT~SDGT~TWBFT-SHTC || Date Entered: 2001/02/07 | Date Updated: 2023/06/13 | Further Information: [AUSTRALIA SANCTIONS - DFAT] No 197,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o (Mar 2015 - removed). PRIMARY NAME: Mustafa Mohamed Fadhil. Aliases: AL MASRI, Abd Al Wakil; AL-NUBI, Abu; ALI, Hassan; ANIS, Abu; ELBISHY, Moustafa Ali; FADIL, Mustafa Muhamad; FAZUL, Mustafa; HUSSEIN; JIHAD, Abu; KHALID; MAN, Nu; QUEEN, Mustafa; YUSSRR, Abu; Mustafa Ali Elbishy. DOB: 23 Jun 1976; 1 Jan 1976. POB: Cairo, Egypt. Citizenship: Kenyan.
Additional Information: Kenyan ID No. XXXXXX Serial No. 201735161. [CANADA SANCTIONS - UNSTR] (Dec 2010 - amended. Mar 2015 - removed.) Other Information: UN Ref QI.F.27.01. Also referred to as Hussein and Khalid. Group ID: 6924. [UN SANCTIONS] UNSCR 1267 (1999) (Oct 2001 - addition. Mar 2015 - removed). (QI.F.27.01) QDi.027. PRIMARY NAME: QUEEN MOHAMED FADHIL. DOB: a) 23 Jun. 1976.",
"matchingItems": {
"matchingItem": [
{
"itemMatchType": "NAME",
"inputValue": "QUEEN KING",
"listValue": "QUEEN KING"
}
]
}
},
{
"comments": " Companies: | AL QA'IDA, 7246 | ANSAR AL-ISLAM, 80486 || Associations: | AL-IRAQI, ABD AL-HADI, 39171 | QUEEN, KHALID SHAIKH, 41241 | AL-ZARQAWI, ABU MUSA AB, 98009 || Keywords: ACB~ARMJH-REPET~AZFMS~BYKGB~CANS~CSSF~DBB~DFAT~DFAT-UN~DTTOT~EU~EU-AQ~FFMS~HKGAZ~HKMA~IMHA-BTO~IMOD~INTERPOL~IOMSO~JERSANC~JMOF~KGFIU~KOFIU~KYSANC~LGB~MAS~MFSANC~MINEFI~NZPOL~OFAC~PBC~RBI-SANC~RSA-AT~SCFM-TERR~SDGT~SECO~SECO-AT~SICCFIN~TTFIU~TWBFT-SHTC~TWMOJ-INT~UE~UKHMT~UKSANC~UN~UN1267~UNSTR~UZDCEC-INT~ZA-FICTFS || Date Entered: 2007/06/08 | Date Updated: 2023/08/28 | Further Information: [AUSTRALIA SANCTIONS - DFAT] No 2529,a,b,b1,b2,b3,c,d,d1,d2,e,f,g (Mar 2012 - addition. Jan 2022 - amended). PRIMARY NAME: QUEEN KING. aka: Hassan Ghul; Hassan Gul; Hasan Gul; Khalid Mahmud; Abu-Shaima; Abu- Shayma; Ahmad Shahji; Mustafa QUEEN; Abu Gharib al-Madani. Date of Birth: a) Between Aug. and Sep 1977,",
"matchingItems": {
"matchingItem": [
{
"itemMatchType": "NAME",
"inputValue": "QUEEN KING",
"listValue": "QUEEN KING"
},
{
"itemMatchType": "ADDRESS",
"inputValue": "1234 Main St,Tokyo,JA,SA,60606",
"listValue": "SAUDI ARABIA"
}
]
}
}
]
}
}
]
}
]
}
}
}
]
}
]Related
- For more information about parameters, see Entity Validation parameters.
- For more information about the status responses and error codes supported by the Validation Services API, see Validation Services error response codes.
Next steps
- Learn how to verify a business entity.