v1
latestOpenAPI 3.0.02026-07-2667172347.6 KBAdd sensitive client
Use this endpoint to add a <Glossary>client</Glossary> profile to your <Glossary>sensitivity list</Glossary> .
Headers
The access_token returned in your most recent Create access token response.
Request body
The unique identifier for the client’s Identity Verification case. <br /><br />Format: uuid string <br /><br />Example: 790f325a-48c9-4b82-bb53-c0ea128236f0 <br /><br /><img src="https://files.readme.io/8eb9022-Inline_Tip.svg" align="left"/>Tip: This is the same value as the workflowId returned in the Create workflow response. <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left"/>Important: <br />• If you provide a verificationId, you can’t set any other body parameters in this request, except for enabled. <br />• The verificationId must exist. <br />• We then automatically populate the sensitive client profile with the <Glossary>personal data</Glossary> from that case
The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith <br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left"/>Important: <br />This parameter is required if verificationId isn’t provided
The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
Any other names the client is known by. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Muscles
The sensitivity list category the client falls into. <br />You can define any categories that you want to track. <br /><br />Format: Free text
The sensitivity list subcategory the client falls into. <br />You can define any subcategories that you want to track. <br /><br />Format: Free text
The client’s date of birth. <br /><br />Format: Date YYYY-MM-DD <br /><br />Example: 1960-10-18= October 18, 1960
The city where the client was born. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Sint-Agatha-Berchem
The document number of the client’s ID document(s).
The client’s <Glossary>TIN</Glossary>. <br /><br />Example: 12.34.56-789.01
The country or countries where the client has citizenship <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Belgium, United States
The client’s sex <br /><br />Format: Case sensitive <br />Enum: <br />• Female: Female in line with ID document <br />• Male: Male in line with ID document <br />• Other: ID document contains a value other than Male or Female <br />• Unknown: ID document contains no gender field
The client’s mobile phone number. <br /><br />Format: Must include the country code and begin with 00 or + without spaces <br /><br />Example: 00324123456789 or +324123456789
Your reference number for the client. <br /><br />Format: Free text
Any additional information. <br /><br />Format: Free text
The client’s email address. <br /><br />Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9 <br /><br />Example: j.smith@example.com
• true: This profile is active on your sensitivity list (default). <br /><br />• false: This profile isn’t active on your sensitivity list.
Response
Sensitive client added
Our unique identifier for the sensitive client, returned in the Add sensitive client response. <br /><br />Format: uuid string <br /><br />Example: 790f325a-48c9-4b82-bb53-c0ea128236f0
The URL where you can retrieve the sensitive client profile.