Initiaite an Individual Client Assessment
POST {{baseurl}}/v2/api/actors/risk/assessment
This endpoint allows you to initiate an individual client assessment, also known as an individual actor or entity, depending on your nomenclature. This is typically an individual you have a business or commercial relationship with.
Header
| Name | Type | Description |
|---|---|---|
token* | String | API token |
Body
| Field | Type | Description |
|---|---|---|
type* | String | type of customer - one of |
firstName* | String | firstName of customer - |
lastName* | String | lastName of customer - |
middleName | String | middleName of customer - |
businessName* | String | businessName of customer - |
city* | String | Address city - |
country* | String | Address country code - |
industry | String | industry of customer - |
lengthOfStay | Number | Address length Of Stay - |
ageOfAccount | Number | Age of Account - |
previousAdverseMediaScore | Number | Previous Adverse Media Score - |
previousRiskScore | Number | Previous Risk Score - |
adverseMediaQueryDateRange* | Object | Date Range for the adverse Media Query |
startDate* | String | start Date for the adverse Media Query |
endDate* | String | end Date for the adverse Media Query |
kycVerifiedBy* | String | KYC verified By one of |
isBeneficiary | Number | is the risk assessment for a transaction beneficiary - |
customWeight | Object | business custom weight - |
kyc | Number | kyc weight |
industry | Number | industry weight |
city | Number | city weight |
country | Number | country weight |
sanction | Number | sanction weight |
pep | Number | pep weight |
adverse_media | Number | adverse media weight |
{
"type": "individual",
"firstName": "Ahmed",
"lastName": "Al Khalid",
"middleName": null,
"businessName": null,
"city": "lagos",
"country": "NG",
"kycVerifiedBy": "not_verified",
"lengthOfStay": 30,
"industry": "arms_dealers",
"ageOfAccount": 50,
"previousAdverseMediaScore": 60,
"previousRiskScore": 40,
"adverseMediaQueryDateRange": {
"startDate": "2023-05-23",
"endDate": "2023-06-23"
},
"isBeneficiary": false
}{
"success": true,
"statusCode": 200,
"message": "customer assessment successful!",
"data": {
"success": true,
"statusCode": 200,
"message": "customer assessment successful!",
"data": {
"geographic": {
"weight": 0.25,
"country": "NG",
"countryScore": 56.78,
"countryScoreStatus": "Potential High Risk",
"city": "lagos",
"cityScore": 67.6,
"cityScoreStatus": "Potential High Risk",
"lengthOfStayScore": 50.000000002,
"lengthOfStayScoreStatus": "Potential Medium Risk",
"actualScore": 58.5330000006,
"actualScoreStatus": "Potential Medium Risk",
"weightedScore": 14.63325000015
},
"product": {
"weight": 0.25,
"industryScore": 100,
"industryScoreStatus": "Potential High Risk",
"occupationScore": 0,
"occupationScoreStatus": "Low Risk",
"actualScore": 90,
"actualScoreStatus": "Critical High Risk",
"weightedScore": 22.5
},
"personal": {
"weight": 0.5,
"name": "Twitter",
"kycScore": 100,
"kycScoreStatus": "Not Verified. High Risk.",
"sanctionScore": 0,
"sanctionScoreStatus": "Sanction Clear",
"pepScore": 0,
"pepScoreStatus": "PEP Clear",
"adverseMediaScore": 77.23333333333333,
"adverseMediaScoreStatus": "Potential High Risk",
"pAdverseMediaScore": 60,
"pAdverseMediaScoreStatus": "Potential Medium Risk",
"accountAgeScore": 16.666666670000012,
"accountAgeScoreStatus": "Potential Medium Risk",
"citizenshipScore": 68.8,
"citizenshipScoreStatus": "Potential High Risk",
"actualScore": 42.279166667,
"actualScoreStatus": "Potential Medium Risk",
"weightedScore": 21.1395833335
},
"basicRiskScore": 58.27283333365,
"previousRiskScore": 40,
"riskScore": 58.27283333365,
"riskStatus": "Potential Medium Risk",
"adverseMediaNews": [
{
"date": "2023-06-18 14:50:43",
"source": "https://www.foxbusiness.com/technology/twitter-kicked-out-colorado-offices-latest-court-battle-unpaid-rent",
"headline": "Twitter kicked out of Colorado offices in latest court battle over unpaid rent",
"excerpt": "A judge in Boulder, Colorado, ordered the sheriff's office to evict Twitter from office space locations over the company allegedly not paying rent, court documents show.",
"score": 86.25999999999999,
"inferring": "Negative",
"tags": [
[
"civil lawsuit",
70
]
],
"language": "en",
"persons": [
"Twitter ",
"David Odisho ",
"File ",
"Marlena Sloss/Bloomberg ",
"Elon Musk ",
"Musk "
],
"organizations": [
"Boulder County ",
"Lot ",
"SBO ",
"Twitter ",
"Gregory Bull ",
"AP Newsroom ",
"TWITTER ",
"LANDLORD ",
"MUSK FOR ",
"Boulder ",
"FOX Business "
],
"site": null,
"country": "US",
"_id": "64958838e58100661ccc3e9d"
},
{
"date": "2023-06-15 08:24:21",
"source": "https://finance.yahoo.com/news/music-publishers-are-suing-twitter-for-250-million-over-massive-copyright-infringement-082421118.html",
"headline": "Music publishers are suing Twitter for $250 million over 'massive' copyright infringement",
"excerpt": "Twitter has yet another major lawsuit to contend with. A group of more than a dozen music publishers has filed a $250 million lawsuit against the company over allegations of 'massive' copyright…",
"score": 85.69,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"Elon Musk ",
"Musk "
],
"organizations": [
"NMPA Notices ",
"Twitter ",
"DMCA ",
"Digital Millennium "
],
"site": null,
"country": "US",
"_id": "64958838e581006ea6cc3e9e"
},
{
"date": "2023-06-08 05:08:27",
"source": "https://www.infowars.com/posts/twitter-files-fbi-worked-with-ukraine-to-censor-twitter-users-including-journalists",
"headline": "Twitter Files: FBI Worked With Ukraine to Censor Twitter Users, Including Journalists",
"excerpt": "Infowars: There's a War on for your Mind!",
"score": 81.41499999999999,
"inferring": "Negative",
"tags": [
[
"arms trafficking",
90
]
],
"language": "en",
"persons": [
"Twitter ",
"Twitter Files ",
"Aaron Maté ",
"Click ",
"Biden "
],
"organizations": [
"FBI ",
"SBU ",
"Federal Bureau ",
"Security Service ",
"Twitter Files "
],
"site": null,
"country": "US",
"_id": "64958838e581001805cc3e9f"
},
{
"date": "2023-06-06 20:44:06",
"source": "https://www.cnn.com/2023/06/06/tech/twitter-files-lawyers/index.html",
"headline": "Twitter's own lawyers refute Elon Musk's claim that the ‘Twitter Files' exposed US government censorship",
"excerpt": "(CNN) — For months, Twitter owner Elon Musk and his allies have amplified baseless claims that the US government illegally coerced Twitter into censoring a 2020 New York Post article about Hunter…",
"score": 88.35,
"inferring": "Negative",
"tags": [
[
"civil lawsuit",
70
]
],
"language": "en",
"persons": [
"Twitter ",
"Elon Musk ",
"Hunter Biden ",
"Files ",
"Donald Trump ",
"Musk ",
"Joe Biden ",
"Trump ",
"Biden ",
"Plaintiffs ",
"Discovery Company "
],
"organizations": [
"CNN ",
"Musk ",
"Twitter Files ",
"Twitter ",
"FBI ",
"Constitution ",
"First ",
"Trump ",
"US Capitol ",
"Cable News Network ",
"Warner Bros "
],
"site": null,
"country": "US",
"_id": "64958838e5810004e5cc3ea0"
},
{
"date": "2023-06-15 08:18:50",
"source": "https://images.dawn.com/news/1191859",
"headline": "Twitter hit with $250mn copyright infringement lawsuit from music publishers",
"excerpt": "The lawsuit claims that the problem of copyright infringement on Twitter has escalated since the platform came under the ownership of Elon Musk.",
"score": 80.465,
"inferring": "Negative",
"tags": [
[
"sanction violations",
85
],
[
"piracy / counterfeiting",
80
]
],
"language": "en",
"persons": [
"Universal Music Publishing Group ",
"Warner Chappell Music ",
"Sony Music Publishing ",
"Twitter ",
"Drake ",
"Taylor Swift ",
"Adele ",
"Peloton ",
"Roblox ",
"David Israelite ",
"Variety ",
"Elon Musk "
],
"organizations": [
"NMPA ",
"USA ",
"TikTok ",
"DMCA ",
"CEO ",
"Publishers ",
"Twitter "
],
"site": null,
"country": "IN",
"_id": "64958838e581006d14cc3ea1"
},
{
"date": "2023-06-14 22:39:48",
"source": "https://www.slashgear.com/1314345/twitter-sued-songwriters-music-copyright-violations/",
"headline": "Twitter Hit With $250 Million Lawsuit Over Alleged Music Copyright Violations",
"excerpt": "Elon Musk's financially-strained Twitter has been hit with a lawsuit seeking $250 million over its alleged ongoing music copyright infringement issues.",
"score": 83.22000000000001,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
],
[
"civil lawsuit",
70
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"Musk "
],
"organizations": [
"Twitter ",
"NMPA "
],
"site": null,
"country": "US",
"_id": "64958838e58100baf0cc3ea2"
},
{
"date": "2023-06-14 21:40:22",
"source": "https://seekingalpha.com/news/3979991-music-publishers-sue-twitter-over-alleged-copyright-infringement",
"headline": "Music publishers sue Twitter over alleged copyright infringement (NYSE:SONY)",
"excerpt": "The National Music Publishers Association sued Twitter, claiming that the social media platform violates the copyright of songwriters by using their music without permission. A group of...",
"score": 90.345,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"Warner Music Group ",
"Sony Music ",
"Elon Musk ",
"Musk ",
"Twitter U.S. ",
"Linda Yaccarino ",
"Twitter CEO "
],
"organizations": [
"NASDAQ ",
"NYSE ",
"OTCPK ",
"Twitter "
],
"site": null,
"country": "US",
"_id": "64958838e581002c98cc3ea3"
},
{
"date": "2023-06-15 08:24:21",
"source": "https://www.engadget.com/music-publishers-are-suing-twitter-for-250-million-over-massive-copyright-infringement-082421118.html",
"headline": "Music publishers are suing Twitter for $250 million over 'massive' copyright infringement",
"excerpt": "A group of more than a dozen music publishers is suing Twitter for $250 million over allegations of 'massive' copyright infringement on the platform..",
"score": 85.69,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"Elon Musk ",
"Musk "
],
"organizations": [
"NMPA Notices ",
"Twitter ",
"DMCA ",
"Digital Millennium ",
"Engadget "
],
"site": null,
"country": "US",
"_id": "64958838e58100d345cc3ea4"
},
{
"date": "2023-06-15 15:44:00",
"source": "https://news.yahoo.com/music-labels-sue-twitter-250-154400196.html",
"headline": "Music Labels Sue Twitter for $250 Million as Its Reputation Circles the Drain",
"excerpt": "Music labels sued Twitter for copyright infringement in a class action lawsuit filed on Wednesday. The labels claim the social media company used copyrighted music to increase the amount of time users…",
"score": 82.365,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"Taylor Swift ",
"Elon Musk ",
"David Israelite ",
"Musk ",
"Instagram ",
"Linda Yaccarino ",
"Gizmodo "
],
"organizations": [
"NMPA ",
"Digital Millennium ",
"DMCA ",
"TikTok ",
"YouTube ",
"CEO ",
"Twitter "
],
"site": null,
"country": "US",
"_id": "64958838e58100c6cccc3ea5"
},
{
"date": "2023-05-31 11:20:19",
"source": "https://www.indiatimes.com/technology/news/twitter-could-face-europe-ban-604433.html",
"headline": "EU Demands Twitter's Compliance With Disinformation Rules Or Risk Ban",
"excerpt": "When Elon Musk bought Twitter last year, he said that one of the key factors driving his purchase was his commitment to ensure freedom of expression and transparency",
"score": 78.85,
"inferring": "Negative",
"tags": [
[
"fraud",
90
],
[
"sanction violations",
85
]
],
"language": "en",
"persons": [
"Twitter ",
"France Info ",
"Jean-Noël Barrot ",
"Barrot ",
"Thierry Breton ",
"Beyond ",
"Elon Musk ",
"Musk ",
"Unsplash ",
"Elon Musk Teases New Twitter Features Including Voice Calls ",
"Earlier "
],
"organizations": [
"European Union ",
"Digital ",
"Meta ",
"Microsoft ",
"Digital Services ",
"Commissioner ",
"Internal Market ",
"Twitter ",
"DSA ",
"Reuters ",
"Community Notes ",
"Encrypted "
],
"site": null,
"country": "IN",
"_id": "64958838e581002493cc3ea6"
},
{
"date": "2023-06-14 20:55:46",
"source": "https://variety.com/2023/music/news/twitter-250-million-copyright-infringement-lawsuit-music-publishers-1235644414/",
"headline": "Twitter Hit With $250 Million Copyright-Infringement Lawsuit From Music Publishers",
"excerpt": "The National Music Publishers Assn., acting on behalf of 17 major music publishers, is filing a federal copyright infringement lawsuit against Twitter for its failure to license and pay for the mus…",
"score": 81.13,
"inferring": "Negative",
"tags": [
[
"sanction violations",
85
],
[
"piracy / counterfeiting",
80
]
],
"language": "en",
"persons": [
"Twitter ",
"Anthem Entertainment ",
"Big Machine Music ",
"Hipgnosis Songs Group ",
"Kobalt Music ",
"Mayimba Music ",
"Reservoir Media Management ",
"Sony Music Publishing ",
"Spirit Music Group ",
"Ultra Music Publishing ",
"Warner Chappell Music ",
"Wixen Music Publishing ",
"Peloton ",
"Roblox ",
"Elon Musk ",
"David Israelite "
],
"organizations": [
"Publishers ",
"Twitter ",
"UMPG ",
"ABKCO Music ",
"Royalty Network ",
"NMPA ",
"TikTok ",
"CEO ",
"DMCA "
],
"site": null,
"country": "US",
"_id": "64958838e5810004d2cc3ea7"
},
{
"date": "2023-05-31 18:00:00",
"source": "https://www.globenewswire.com/news-release/2023/05/31/2679728/0/en/UPDATE-Berliner-Tageszeitung-Criminal-complaint-in-Berlin-Germany-against-Elon-Musk-and-Twitter-for-possible-fraud-to-the-detriment-of-users.html",
"headline": "UPDATE – Berliner Tageszeitung: Criminal complaint in Berlin, Germany, against Elon Musk and Twitter for possible fraud to the detriment of users",
"excerpt": "BERLIN, May 31, 2023 (GLOBE NEWSWIRE) -- BERLINER TAGESZEITUNG reports today that a criminal complaint has been filed against Elon Musk with the Berlin...",
"score": 82.935,
"inferring": "Negative",
"tags": [
[
"fraud",
90
]
],
"language": "en",
"persons": [
"Elon Musk ",
"Musk ",
"Twitter ",
"Source ",
"Tesla CEO Elon Musk ",
"Edward Chen ",
"Elon Musk Twitter ",
"Elon Musk Strafanzeige ",
"Thierry Breton ",
"Thierry Breton Twitter ",
"Berlin ",
"Berliner Tageszeitung "
],
"organizations": [
"GLOBE ",
"BERLINER ",
"Berlin ",
"Twitter ",
"Federal Republic ",
"US ",
"District Court ",
"Fundamental Rights ",
"European Union ",
"META "
],
"site": null,
"country": "US",
"_id": "64958838e5810016d0cc3ea8"
},
{
"date": "2023-06-13 17:15:06",
"source": "https://www.business-standard.com/india-news/mos-it-slams-former-twitter-founder-dorsey-s-comments-on-farmer-protest-123061300673_1.html",
"headline": "Chandrasekhar slams Twitter ex-CEO Dorsey's comments on farmer protest",
"excerpt": "Jack Dorsey: \"This is an outright lie by @jack - perhaps an attempt to brush out that very dubious period of Twitters history,\" said the Minister in his tweet",
"score": 89.585,
"inferring": "Negative",
"tags": [
[
"fraud",
90
],
[
"falsifying information on official documents",
80
]
],
"language": "en",
"persons": [
"Shivani ",
"Shinde Mumbai ",
"Jack Dorsey ",
"Twitter ",
"Chandrasekhar ",
"Dorsey ",
"Dorseys Twitter ",
"Such ",
"Jack ",
"Bluesky Social ",
"Irdai ",
"Sahara ",
"Safe ",
"Jack Dorsey Twitter "
],
"organizations": [
"Farmer Protests ",
"YouTube ",
"CEO Twitter ",
"USA ",
"CAG ",
"SAT ",
"Life Insurance ",
"SBI Life "
],
"site": null,
"country": "IN",
"_id": "64958838e581002e7ecc3ea9"
},
{
"date": "2023-06-15 15:44:00",
"source": "https://gizmodo.com/twitter-nmpa-music-labels-sue-copyright-infringement-1850543130",
"headline": "Music Labels Sue Twitter for $250 Million in Copyright Infringement",
"excerpt": "Twitter is facing yet another lawsuit. 17 music labels representing Beyonce, Taylor Swift, and others are alleging major copyright infringement.",
"score": 82.07999999999998,
"inferring": "Negative",
"tags": [
[
"piracy / counterfeiting",
80
]
],
"language": "en",
"persons": [
"Twitter ",
"Taylor Swift ",
"Elon Musk ",
"David Israelite ",
"Musk ",
"Instagram ",
"Linda Yaccarino "
],
"organizations": [
"NMPA ",
"Digital Millennium ",
"DMCA ",
"TikTok ",
"YouTube ",
"CEO ",
"Twitter "
],
"site": null,
"country": "US",
"_id": "64958838e58100df71cc3eaa"
},
{
"date": "2023-05-23 18:00:18",
"source": "https://www.makeuseof.com/twitters-history-security-lapses/",
"headline": "Twitter's History of Security Lapses and How They Affected Users",
"excerpt": "Twitter's suffered many data breaches in the past, affecting millions of users. Only by knowing of these breaches can you protect yourself in future.",
"score": 81.89000000000001,
"inferring": "Negative",
"tags": [
[
"sanction violations",
85
],
[
"cybercrime / hacking / phishing",
80
]
],
"language": "en",
"persons": [
"Twitter ",
"Barack Obama ",
"Partner Audiences ",
"Guardian ",
"Omar Abdulaziz ",
"Google Play Store ",
"Elon Musk ",
"Bill Gates ",
"Kanye West ",
"Joe Biden ",
"Biden "
],
"organizations": [
"Associated ",
"Tailored Audiences "
],
"site": null,
"country": "CA",
"_id": "64958838e58100d8e2cc3eab"
}
],
"adverseMediaNewsReason": " The lawsuit alleges that Twitter has violated the copyright of songwriters by using their music without permission."
},
"links": []
}{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}Last updated