# Initiate an Individual Client Assessment
`POST` `{{baseurl}}/v1/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 `individual or business` |
| firstName\* | String | firstName of customer - `if customer is individual` |
| lastName\* | String | lastName of customer - `if customer is individual` |
| middleName | String | middleName of customer - `if customer is individual` |
| businessName\* | String | businessName of customer - `if customer is business` |
| city\* | String | Address city - `required for both types` |
| country\* | String | Address country code - `required for both types` |
| industry | String | industry of customer - `applies for both types` |
| lengthOfStay | Number | Address length Of Stay - `in months, applies for both types` |
| ageOfAccount | Number | Age of Account - `in months, applies for both types` |
| previousAdverseMediaScore | Number | Previous Adverse Media Score - `applies for both types` |
| previousRiskScore | Number | Previous Risk Score - `applies for both types` |
| adverseMediaQueryDateRange\* | Object | Date Range for the adverse Media Query `required for individual or business , but for beneficiaries send as "null"` |
| 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 `youverify - if KYC was verified by youverify, client - if KYC was verified by client, not_verified - if KYC has not been verified, expired_30 - if ID has expired within the last 30 days, expired_90 - if ID has expired within the last 90 days` |
| isBeneficiary | Number | is the risk assessment for a transaction beneficiary - `applies for both types, "true, if the risk assessment is for a transaction beneficiary, "false", if it's not"` |
| customWeight | Object | business custom weight - `if business has a custom weight set` |
| 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 |
{% tabs %}
{% tab title="Sample Request for Individuals" %}
```json
{
"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
}
```
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="Success Response for Individual" %}
```json
{
"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": []
}
```
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="Error Response" %}
```json
{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.youverify.co/know-your-transaction-service-kyt/customer-management/initiate-an-individual-client-assessment.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.