Watchlists, Politically Exposed Persons, Adverse Media Screening

introduction this api can be used for 3 different screenings based on the input provided by client as mentioned below a) global watchlists & sanction sceening signzy's global watchlists & sanction offers data from more than 6000 global source daily to alert you about potential sanction risks when screening candidates, vendors, or other business partners global watchlists are compiled by governments and international organizations to identify entities linked to crime, corruption, terrorism, laundering, and various other forms of unethical behavior entities include individuals, corporations, or even countries even if they aren’t actively committing a crime, listed entities may be connected to suspicious activity engaging in risky business relationships with suspicious parties can result in severe regulatory penalties, financial loss, and reputational damage b) politically exposed persons (pep) screening signzy's politically exposed persons screening uses data from government databases, a lot of other datasources & analyze media sources daily to uncover pep associations not listed by governments or other common sources, looking at family members and close associates as well as the individual in question politically exposed persons are individuals connected to high level roles in a government, either directly, through family members, or through close personal and business relationships peps are considered higher risk customers because their proximity to power offers more opportunities to engage in unethical or unlawful behavior, such as nepotism, money laundering, and embezzlement international aml/kyc regulations for financial services, banking, and other sectors often require ongoing monitoring of peps while pep status is not an automatic dealbreaker, it may be a sign you need to implement extra aml/cft protocols and conduct specialized due diligence signzy offers an easier, more affordable solution for reducing reputational and financial risk while supporting smarter compliance decisions c) adverse/negative media screening signzy's adverse media screening uses data from public sources by crawling the web for relevant information on a daily basis, leveraging sentiment analysis and negative keywords to reduce false positives adverse media detection serves as an important early predictor for potential watchlist or sanctions listings, as media outlets can often identify risk with more agility than government or international watchdogs red flag behavior linked to money laundering, financial fraud, drug trafficking, human trafficking, risky finances, terrorism — and more — can be better identified and predicted with adverse media screening adverse media source examples bbc, the new york times, al jazeera, washington post, gulf news, cnn, the telegraph, fox news, the world bank, wallstreet journal, mumbai mirror, the asian age, the seattle times, caribbean new now, china daily, the indian express, bangkok post, sydney morning herald, chicago tribune, newsroom panama, winnipeg sun, and thousands more api details you must first login before sending the request the authorization header in the request must include the access token obtained from the login api call please note that all country code parameters are supported in iso 3166 1 alpha 3 format please check the codes table here & use alpha 3 code for country related fields https //en wikipedia org/wiki/iso 3166 1 https //en wikipedia org/wiki/iso 3166 1 sample curl curl location request post 'https //api signzy us/api/v3/global/pep nm wls' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "subject" "donald trump", "subjectid" "ga94924 83", "categories" "allpp", "needstranslation" false, "dateofbirthfilter" false, "matchscorethreshold" 1 0, "aliases" \[ "potus" ], "parameters" { "age" "56", "dateofbirth" "7/3/1962", "free text" "keyword1; keyword2", "identifier" "some identifier", "address line 1" "123 peachtree st", "city/district" "atlanta", "state/province/region/locality" "ga", "country" "usa", "countrycodes" "usa,can", "postal code" "30303", "source country" "usa" }, "options" { "wls" { "countrycodes" \[ "ind","usa", "sgp" ] }, "pep" { "excludefields" \[ "social", "business relations" ], "profilelevels" \[ 1, 2, 3 ] } }, "monitoring" { "monitor" false } }'curl location request post 'https //api preproduction signzy app/api/v3/global/pep nm wls' \\ \ header 'authorization < auth token >' \\ \ header 'content type application/json' \\ \ data raw '{ "subject" "donald trump", "subjectid" "ga94924 83", "categories" "allpp", "needstranslation" false, "dateofbirthfilter" false, "matchscorethreshold" 1 0, "aliases" \[ "potus" ], "parameters" { "age" "56", "dateofbirth" "7/3/1962", "free text" "keyword1; keyword2", "identifier" "some identifier", "address line 1" "123 peachtree st", "city/district" "atlanta", "state/province/region/locality" "ga", "country" "usa", "countrycodes" "usa,can", "postal code" "30303", "source country" "usa" }, "options" { "wls" { "countrycodes" \[ "ind","usa", "sgp" ] }, "pep" { "excludefields" \[ "social", "business relations" ], "profilelevels" \[ 1, 2, 3 ] } } }' request body parameters parameter data type required description content type yes application/json authorization yes authorization token subject string yes name of individual or business subjectid string sometimes when using with monitoring this is the id the client has assigned to the subject used to match the response to the record in the client’s database needstranslation boolean optional whether the subject and/or aliases needs to be translated this only translates the subject name from non latin characters (e g chinese, japanese, greek, russian) to latin characters please only pass true for entries that need to be translated from nonlatin characters into latin characters please do not pass true for all api calls by default, this feature will slow down your response time dateofbirthfilter boolean optional when set to true, only results that match the searched dob will be returned set to false, all results with namematch scores at or above the relevancy score setting will be returned default is false please note that if the result does not contain a dob value, it will be returned regardless of the setting being true or false matchscorethreshold float optional this parameter enables the user to set a threshold score above which the data would be returned back categories string yes product category( ies) to search when using more than one product category separate each value with a comma or semicolon there should be no space after each catogery while entering multiple catogeries at once ex if there are two or more entries at the same then the entries should be like allwl,allnm see categories section below aliases\[] list list of any aliases to search parameters object optional optional search criteria parameters age string optional number value entered as a text parameters dateofbirth string optional individual's age entered as text parameters free text string optional input any keyword text you would like added to the search several search words or phrases should be separated by a comma or a semicolon parameters identifier string optional any values associated to the individual or business for example passport number or business license parameters address line 1 string optional in the us this value would be the number and street name parameters address line 2 string optional in the us this value would be the suite or po box parameters city/district string optional city or district parameters state/province/region/locality string optional state, province, region, or locality parameters country string optional country of the searched subject parameters countrycodes string optional comma separated list of country codes expressed in iso 3166 1 alpha 3 format currently only used to filter level 1 and level 2 pep profiles please note that any of the following codes will be accepted for yugoslavia (bih, hrv, mkd, mne, srb, and rsk) – bih will always be the displayed code in the pep profile parameters postal code string optional postal code parameters source country string optional identifies the country where the data was captured expressed in iso 3166 1 alpha 3 format (this is used for increasing the match score options object optional additional search options options wls object optional additional search options for wls searches options countrycodes list optional provide country codes to filter the source countries for watchlists expressed in iso 3166 1 alpha 3 format options pep object optional additional search options for pep searches options am object optional additional search options for am searches options countrycodes list optional provide country codes to filter the source countries for aml expressed in iso 3166 1 alpha 3 format options pep excludefields list optional string enumeration of fields to not return from a pep profile possible values include "professional history", "member of", employer", "education", "awards received", "notable work", "convicted", "sourceinfourl" "affiliation", "family members", "social", "business relations", "business partnerships", "lobbying", "stakeholder", and "contributions" please note an error will not occur for any provided value not in our list of acceptable values options pep profilelevels list optional numeric value indicating what pep profile levels to search possible values are 1,2,3 1 – profile name 2 – profile alias 3 – profile relations categories watchlist categories abbreviation name allwl all wls categories activ activist amlkc aml/kyc compliance exdeb exclusion/debarment finan financial glcrm global criminal glhlc global healthcare gwlas global watch lists and sanctions imexp import/export natcf national criminal file nathc national healthcare oighs office of the inspector general rlest real estate samge sam gov exclusions samgv sam gov sxoff sex offenders wcorr corruption wofac ofac wterr terrorism adverse/negative media categories abbreviation name description allnm all nm categories contains all adverse news types anrts animal rights this category contains adverse news geared towards animal rights which includes news of animal cruelty, arrests, lawsuits etc bufin business & financial contains adverse news from business and financial articles crcrt crime & courts contains adverse news involving crime and courts a few examples include o investigations o news on trials o news on arrests o police logs o news on sentencings o news on legal cases gnews general news contains all adverse news types (with the exception of sports, celebrity news, gossip, weather) a few examples include; o regional news o top stories o featured news o world news misec military & security contains adverse news involving military and nation security a few examples include; o war and conflict o defense news o news on terrorism/terrorist o international criminal court news o country relations o government briefs o sanctions o news from intelligence agencies nmcor corruption o news of bribery o news of embezzlement 5 o political corruption o news from anti corruption agencies o whistle blower news o news of investigations/arrests/cases/trials for corruption o misconduct news pogov politics & government contains adverse news involving politics or government a few examples include; o brexit news o parliament news o political news o embassies news o election news o federal/state/city politics o government news politically exposed persons (pep) categories abbreviation name allpp all pep categories sample response (wls, am, pep) { "approximatetotalrecords" 1521, "subject" "donald trump", "subjectid" "ga94924 83", "results" { "subject" "donald trump", "results" { "wlsresults" \[ { "score" 0 8825105, "category" "natcf,sxoff", "productid" "wls", "resultid" 1, "sourceid" 124, "address" "265 e jackson st dover, nj 07801", "age" "59 (dob 03/30/1959)", "aliaslist" "donald thompson", "caution" "2c 24 4a endangering the welfare of a child", "dateofbirth" null, "entityname" null, "eyecolor" "brown", "gender" "m", "haircolor" "gray", "height" "5'10''", "highlights" \[], "identifier" "231981", "individualname" "donald t thompson", "nationality" null, "placeofbirth" null, "program" null, "race" "white", "remarks" "scar on l eye () , scar on head () , scar on forehead () , scar on nose () , scar on back ()", "sourceagencyacronym" "n/a", "sourceagencyname" "new jersey state police", "sourcelisttype" "state sex offender registry", "sourceparentagency" "n/a", "sourceregion" "north america", "subjectmatched" "donald t thompson", "text" "offender search offender details details name donald t ", "url" "http //www icrimewatch net/ ", "weight" "176lbs" } ], "nmresults" \[ { "score" 1, "category" "gnews", "productid" "nm", "resultid" 3, "sourceid" 323, "highlights" \[], "subjectmatched" "donald trump", "text" "nearly 100 of america's top tech companies like apple, google and facebook " } ], "pepresults" \[ { "score" 1, "productid" "pep", "profileid" 73616, "resultid" 4, "country" "united states of america", "countrycode" "usa", "name" "donald trump", "gender" "male", "placeofbirth" "jamaica hospital", "dateofbirth" "1946 06 14", "dateofdeath" null, "birthname" "donald john trump", "nativename" "donald trump", "professionalhistory" \[ "president of the united states of america", "director", "chairperson" ], "memberof" \[ "forbes list of billionaires", "republican party" ], "employer" \[], "education" \[ ], "awardsreceived" \[ ], "notablework" \[ ], "convicted" \[], "sourceinfourl" \[], "address" \[ ], "aliases" \[ ], "scoreboosts" \[ "score boosted from 1 to 1 02 (profile id 73616) alias the don found in the donald" ], "pepsearchtype" 0, "familymembers" \[ { "relationtype" "relative", "name" "elizabeth trump" }, { "relationtype" "spouse", "name" "ivana trump" } ], "social" \[ ], "businessrelations" \[ ], "businesspartnerships" \[ ], "lobbying" \[], "stakeholder" \[ ], "contributions" \[ ] } ] } }, "translatedsubject" null, "translatedresults" { "wlsresult" null, "medresults" null, "nmresults" null, "pepresults" null }, "alaisresults" \[ { "subject" "potus", "results" { "wlsresults" \[ ], "medresults" \[ ], "nmresults" \[ ], "pepresults" \[ ] }, "translatedsubject" null, "translatedresults" { "wlsresult" null, "medresults" null, "nmresults" null, "pepresults" null } } ], "monitor" { "monitorid" "15249ac5 19d8 4bbf 8c2f 50244e5eecc9", "duplicate" false, "success" true, "message" "monitor successfully created" }, "searchedproducts" { "wls" { "categories" \[ "finan" ], "minscore" 0 8 }, "nm" { "categories" \[ "gnews", "bufin" ] }, "pep" { "minscore" 0 875 } } } sample response (only adverse media) { "result" { "recordsfound" true, "subject" "riza aziz", "results" { "wlsresults" null, "nmresults" \[ { "productid" "nm", "score" 1, "sourceid" 9837, "category" "crcrt", "resultid" 1, "subjectmatched" "riza aziz", "text" "kuala lumpur former prime minister datuk seri najib tun razak’s wife datin seri rosmah mansor is expected to present herself to the police on friday for her statement to be recorded in connection with the investigation into alleged misappropriation of funds from 1malaysia development berhad (1mdb) according to a source, rosmah will be quizzed by the anti money laundering crime investigation team at menara kpj, jalan tun razak here on friday morning “she was asked to come tomorrow to give her statement, but has requested to postpone the recording of her statement to friday,” the source told bernama the source added that besides rosmah, her sons, riza aziz and mohd norashman najib would also be present to give their statements regarding the investigation on oct 4, inspector general of police tan sri mohamad fuzi harun said the police may call rosmah to record her statement on various cases including 1mdb bernama © new straits times press (m) bhd", "url" "https //www nst com my/news/crime courts/2018/10/424466/1mdb rosmah expected give statement police tomorrow", "sentimentconfidencelevel" "high" }, { "productid" "nm", "score" 1, "sourceid" 9837, "category" "crcrt", "resultid" 2, "subjectmatched" "riza aziz", "text" "kuala lumpur former prime minister datuk seri najib razak did not want a second valuation be done on the assets of 1malaysia development bhd's (1mdb) joint venture partner, petrosaudi international ltd (psi), the high courtm heard today former 1mdb chief executive officer datuk shahrol azral ibrahim halmi said a second valuation could have proved that there was \\"more downside than upside\\" to the deal asked by najib’s lead counsel tan sri muhammad shafee abdullah as to why details about psi’s assets were concealed from the board, shahrol replied “it just did not come up” the ninth prosecution witness said at the time, edward morse was the only independent valuer for psi’s assets and najib, as the chairman of 1mdb board of advisers, had stated there was no need for a second valuation shafee so what does that mean? there was no second valuation?shahrol it means that a second valuation was not preferred my take from this is that he (najib) did not prefer this shafee did he explicitly say he did not want you to make a second valuation?shahrol no, he did not say that the court then heard that fugitive businessman low taek jho or jho low was described as \\"a fox taking care of chicken\\" shafee said this when the witness testified that he went back and forth between najib, low and the 1mdb board of directors shahrol said after a meeting with najib on oct 16, 2009, he went to see low to get the minutes of meeting and went back to the 1mdb board of directors shafee was i wrong to say that jho low was (like) a fox taking care of chicken?shahrol he was in a way facilitating the misappropriation from 1mdb i think it may be worth to know that in 2016, good star ltd (a company owned by low) sent some money to red granite pictures (a company owned by najib’s stepson, riza aziz) shafee why did you go to red granite? we will get to that later let’s concentrate on what you did do not get into anybody else’s problem cross examination before judge collin lawrence sequerah continues tomorrow\ najib, 66, is charged with misappropriating rm2 28 billion of 1mdb funds, money laundering and abuse of power © new straits times press (m) bhd", "url" "https //www nst com my/news/crime courts/2019/10/534177/witness najib said no need second valuation psi assets", "sentimentconfidencelevel" "high" } ], "pepresults" null }, "translatedsubject" null, "translatedresults" { "wlsresults" null, "nmresults" null, "pepresults" null } } } response body parameters parameter data type description approximatetotalrecords integer total number of search results subject string name of individual or business searched subjectid string provided subjectid results object results for the subject includes subject and translated subject aliasresults\[] list the list of results for all aliases includes subject and translated subject results monitor object only populated if the search was marked for monitoring monitor monitorid guid the id for the monitor created monitor duplicate boolean whether a monitor already exists for this subjectid monitor success boolean whether a monitor was successfully created monitor message string a plain text message in regards to creating a monitor searchedproducts object information on the products searched searchedproducts (key) string identifies the product searchedproducts (key) categories\[] list the categories searched for this product searchedproducts (key) minscore float if configured, shows the minimum relevancy score used for this product for this search any results below this value have been excluded watchlist screen result parameters parameter data type description score float the calculated relevancy match percentage is based on matching the name submitted with the name in the record the score could also be boosted if any of the more parameters from the record match with what the user submitted category string category( ies) matched multiple values are comma separated productid string product matched resultid integer unique id for the search result sourceid long internal id assigned for the source address string address information for individual or business age string individual's age aliaslist string individual's alias name(s) and/or business dba(s) caution string any known alerts/sanctions/issues related to the ad subject dateofbirth string individual's date of birth entityname string name of the business eyecolor string individual's eye color gender string individual's gender haircolor string individual's hair color height string individual's height highlights\[] list snippets of text where the name was matched in a text based search identifier string any values associated to the individual or business for example passport number or business license individualname string name of the individual nationality string individual's nationality placeofbirth string hospital and/or city program string type of list, group, or association with which the searched subject may be connected to, per the source race string individual's race remarks string any pertinent remarks about the searched subject which the source chose to highlight sourceagencyacronym string acronym of the agency which represents the source of the result record sourceagencyname string name of the agency which represents the source of the result record sourcelisttype string sourceparentagency string name of the parent agency which represents the source of the record sourceregion string geographic region of the source which represents the result record subjectmatched string the name matched for this document text string any associated unstructured text url string web url for article source weight string individual's weight adverse/negative media result parameters parameter data type description score float the calculated relevancy match percentage category string category( ies) matched multiple values are comma separated productid string product matched resultid integer unique id for the search result sourceid long internal id assigned for the source highlights\[] list snippets of text where the name was matched in a text based search subjectmatched string the name matched for this document text string any associated unstructured text url string web url for article source sentimentconfidencelevel string sentiment confidence level for capture possible values are low, moderate, and high politically exposed persons (pep) result parameters parameter data type description score float the calculated relevancy match percentage productid string product matched profileid long resultid integer unique id for the search result country string country of citizenship countrycode string country code for country of citizenship name string name of pep profile gender string male or female placeofbirth string hospital and/or city dateofbirth string the date the individual as born dateofdeath string the date the individual died, if applicable birthname string name on birth certificate nativename string name of pep profile professionalhistory\[] list list of professional positions held memberof\[] list list of any groups the person belongs to employer\[] list list of employers education\[] list list of schools the person has attended awardsreceived\[] list list of any major award the person has received notablework\[] list list of notable works convicted\[] list list of any crimes or legal issues the person has been convicted of address\[] list any known addresses the pep holds/has held aliases\[] list alias hits from the pep search scoreboosts\[] list explanation of relevancy score boosts pepsearchtype integer pep, alias, or associations familymembers\[] list business partnerships the pep is/was engaged in social\[] list social groups, establishments or friends the pep is/was engaged with businessrelations\[] list business relationships the pep is/was engaged in businesspartnerships\[] list business partnerships the pep is/was engaged in lobbying\[] list lobbying relationships the pep is/was engaged in stakeholder\[] list names of any individuals or businesses which are stakeholders in interest of the pep, or which the pep holds a stake in contributions\[] list business partnerships the pep is/was engaged in sample error { "error" { "name" "error", "message" "invalid date", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" 200 } } error response parameters parameter description error this parameter contains the error error name the name of the error error message the error message error status status of the api error reason reason for error error type type of the error error statuscode request status code from signzy getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at help\@signzy com we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!