Individual
POSThttps://api.sanctionslookup.com/v1/screen
POST /v1/screen with type INDIVIDUAL. Send the name. Add an ID number, date of birth, or country when you have them. Lists and the score threshold are on Request.
{
"subject": {
"subject_ref": "cust_1024",
"type": "INDIVIDUAL",
"name": "Nicolas Maduro",
"identifiers": [
{ "value": "5892464" }
],
"details": {
"date_of_birth": ["1962-11-23"],
"country_code": "VE"
}
}
}
Fields
| Field | Type | Requirement | Description |
|---|---|---|---|
| name | string | required | The person's name. |
| subject_ref | string | optional | Your own ID. Returned in the response when you send it. |
| identifiers | array of objects | optional | Passport, national ID, or another number. Each item is { "value": "..." }. A mismatch does not reject the name. |
| details.date_of_birth | array of strings | optional | One to 32 values. Each is YYYY, YYYY-MM, or YYYY-MM-DD. Matching uses the year. A conflicting year lowers the score unless dob_penalty is false. One year apart is not a conflict. |
| details.gender | string | optional | MALE or FEMALE. |
| details.country_code | string | optional | Two-letter ISO code, for example VE. |
type is required when details is present. The same object goes in subjects for a batch.