@Mostafa

Hi,

You can utilize the "SEQ-screen-sync-individual: Perform Synchronous Screening: Individual" API and pass the secondary fields that you have listed in your question.

Also, before screening please use the "SEQ-pre-group-case-template: Get the case template for a group" API to obtain the template/blueprint of the available list of secondary identifiers that can be used while screening an individual from your group.

Let me know if you need further info.

Hi

Sorry for delay!

I try to using World-Check One API;

I have some question about cases/screeningRequest, before asking let me share some information with you;
At first, I get groups with calling /groups and this is my result:

[
{
"id": "0a3687d0-6c03-13fc-9b07-dfd500000632",
"name": "OneTransfer Remittance Sdn. Bhd - API (P)",
"parentId": null,
"hasChildren": true,
"status": "ACTIVE",
"children": [
{
"id": "0a3687d0-6c03-13fc-9b07-dff100000685",
"name": "OneTransfer Remittance Sdn. Bhd - Screening",
"parentId": "0a3687d0-6c03-13fc-9b07-dfd500000632",
"hasChildren": false,
"status": "ACTIVE",
"children": []
}
]
}
]

after that, I call groups/{ {group-id}}/caseTemplate to get a case template and use it, there is the result:

{
"groupId": "0a3687d0-6c03-13fc-9b07-dfd500000632",
"groupScreeningType": "CASE_MANAGEMENT_AUDIT",
"customFields": [],
"secondaryFieldsByProvider": {
"watchlist": {
"secondaryFieldsByEntity": {
"individual": [
{
"typeId": "SFCT_1",
"fieldValueType": "GENDER",
"regExp": null,
"fieldRequired": false,
"label": "GENDER"
},
{
"typeId": "SFCT_2",
"fieldValueType": "DATE",
"regExp": null,
"fieldRequired": false,
"label": "DATE_OF_BIRTH"
},
{
"typeId": "SFCT_3",
"fieldValueType": "COUNTRY",
"regExp": null,
"fieldRequired": false,
"label": "COUNTRY_LOCATION"
},
{
"typeId": "SFCT_4",
"fieldValueType": "COUNTRY",
"regExp": null,
"fieldRequired": false,
"label": "PLACE_OF_BIRTH"
},
{
"typeId": "SFCT_5",
"fieldValueType": "COUNTRY",
"regExp": null,
"fieldRequired": false,
"label": "NATIONALITY"
}
],
"vessel": [
{
"typeId": "SFCT_7",
"fieldValueType": "TEXT",
"regExp": "[0-9]{7}",
"fieldRequired": false,
"label": "IMO_NUMBER"
}
],
"organisation": [
{
"typeId": "SFCT_6",
"fieldValueType": "COUNTRY",
"regExp": null,
"fieldRequired": false,
"label": "REGISTERED_COUNTRY"
}
]
}
},
"passportCheck": {
"secondaryFieldsByEntity": {
"individual": [
{
"typeId": "SFCT_8",
"fieldValueType": "TEXT",
"regExp": ".{0,1000}",
"fieldRequired": true,
"label": "PASSPORT_GIVEN_NAMES"
},
{
"typeId": "SFCT_9",
"fieldValueType": "TEXT",
"regExp": ".{0,1000}",
"fieldRequired": true,
"label": "PASSPORT_LAST_NAME"
},
{
"typeId": "SFCT_10",
"fieldValueType": "GENDER",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_GENDER"
},
{
"typeId": "SFCT_11",
"fieldValueType": "STATE",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_ISSUING_STATE"
},
{
"typeId": "SFCT_12",
"fieldValueType": "STATE",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_NATIONALITY"
},
{
"typeId": "SFCT_13",
"fieldValueType": "DATE",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_DATE_OF_BIRTH"
},
{
"typeId": "SFCT_14",
"fieldValueType": "PASSPORT_DOCUMENT_TYPE",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_DOCUMENT_TYPE"
},
{
"typeId": "SFCT_15",
"fieldValueType": "TEXT",
"regExp": "^[a-zA-Z0-9<]{0,1000}$",
"fieldRequired": true,
"label": "PASSPORT_ID_NUMBER"
},
{
"typeId": "SFCT_16",
"fieldValueType": "DATE",
"regExp": null,
"fieldRequired": true,
"label": "PASSPORT_DATE_OF_EXPIRY"
}
]
}
}
},
"nameTransposition": {
"selected": true,
"type": "NAME_TRANSPOSITION",
"available": true
},
"mandatoryProviderTypes": [
"WATCHLIST"
]
}

Now I use this person information to test validation:
Full Name: MOHAMED AMIN MOSTAFA
DOB: 11 Oct. 1975
Nationality: Iraq
Gender: Male
and there is my body request that sends to cases/screeningRequest:

{
"groupId": "{ {group-id}}",
"entityType": "INDIVIDUAL",
"providerTypes": [
"WATCHLIST"
],
"name": "MOHAMED AMIN MOSTAFA",
"secondaryFields": [
{
"typeId": "SFCT_1",
"value": "MALE"
}
],
"customFields": [],
"passportCheck": [
{
"typeId": "SFCT_8",
"value": "MOHAMED"
},
{
"typeId": "SFCT_9",
"value": "MOSTAFA"
},
{
"typeId": "SFCT_10",
"value": "MALE"
},
{
"typeId": "SFCT_12",
"value": "IRQ"
}
]
}

and your API returns this (I just selected the first item that had "matchStrength": "EXACT", there is more than one item!!!):

{
"caseId": "4b66ab6e-1173-49e7-8aa1-bfdaaf867a31",
"results": [
{
"resultId": "5nzbfkbicabr1e971gqv3b47u",
"referenceId": "e_tr_wci_194200",
"matchStrength": "EXACT",
"matchedTerm": "MOHAMED AMIN MOSTAFA",
"submittedTerm": "MOHAMED AMIN MOSTAFA",
"matchedNameType": "AKA",
"secondaryFieldResults": [
{
"field": {
"typeId": "SFCT_1",
"value": "MALE",
"dateTimeValue": null
},
"typeId": "SFCT_1",
"submittedValue": "MALE",
"submittedDateTimeValue": null,
"matchedValue": "MALE",
"matchedDateTimeValue": null,
"fieldResult": "MATCHED"
}
],
"sources": [
"b_trwc_TTFIU",
"b_trwc_14",
"b_trwc_53",
"b_trwc_190",
"b_trwc_151",
"b_trwc_130",
"b_trwc_153",
"b_trwc_154",
"b_trwc_110",
"b_trwc_275",
"b_trwc_155",
"b_trwc_156",
"b_trwc_112",
"b_trwc_134",
"b_trwc_454",
"b_trwc_410",
"b_trwc_312",
"b_trwc_117",
"b_trwc_118",
"b_trwc_67",
"b_trwc_69",
"b_trwc_319",
"b_trwc_DFAT-UN",
"b_trwc_48",
"b_trwc_DTTOT",
"b_trwc_KGFIU",
"b_trwc_20",
"b_trwc_180",
"b_trwc_ARMJH-REPET",
"b_trwc_182",
"b_trwc_160",
"b_trwc_162",
"b_trwc_141",
"b_trwc_185",
"b_trwc_143",
"b_trwc_386",
"b_trwc_320",
"b_trwc_188",
"b_trwc_321",
"b_trwc_168",
"b_trwc_445",
"b_trwc_149"
],
"categories": [
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Law Enforcement",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Law Enforcement",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions",
"Sanctions"
],
"creationDate": "2019-12-23T02:38:47.882Z",
"modificationDate": "2019-12-23T02:38:47.882Z",
"primaryName": "Mohamed Amin MOSTAFA",
"events": [
{
"day": 11,
"month": 10,
"year": 1975,
"address": null,
"fullDate": "1975-10-11",
"allegedAddresses": [],
"type": "BIRTH"
}
],
"countryLinks": [
{
"countryText": "IRAQ",
"country": {
"code": "IRQ",
"name": "IRAQ"
},
"type": "LOCATION"
},
{
"countryText": "UNKNOWN",
"country": {
"code": "ZZZ",
"name": "UNKNOWN"
},
"type": "NATIONALITY"
},
{
"countryText": "IRAQ",
"country": {
"code": "IRQ",
"name": "IRAQ"
},
"type": "POB"
},
{
"countryText": "ITALY",
"country": {
"code": "ITA",
"name": "ITALY"
},
"type": "LOCATION"
},
{
"countryText": "IRAQ",
"country": {
"code": "IRQ",
"name": "IRAQ"
},
"type": "NATIONALITY"
}
],
"identityDocuments": [],
"category": "NONCONVICTION TERROR",
"providerType": "WATCHLIST",
"gender": "MALE"
}
]
}

It's fine, now lemme ask my question:
1. I have to use user passport information (full name, date of birth, nationality, and gender) but if I remove secondaryFields or name from my body request, your API rejects it; Does my the shared request valid? And how could I pass only passportCheck fields?
2. Why this system return many items to my request? for this sample that I shared, it returns about 600 items!
3. How I could add the date of birth (SFCT_13, PASSPORT_DATE_OF_BIRTH) to my request? I mean format of it, I couldn't find in your documents;
4. I change some fields of my request (except name) and the result was same! is it correct? for example, I change gender to female or change PASSPORT_NATIONALITY to another country, but the result return matchStrength = EXACT, same as previous result;