Negative Due Diligence API-Basic

The Basic tier of our Negative Due Diligence API provides essential screening capabilities against key databases to identify potential risks associated with individuals or entities. It includes checks against databases such as Politically Exposed Persons (PEPs), UN Sanctions, Ministry of Home Affairs-Unlawful Activities (Prevention) Act, and the US Sanction List.

Negative Databases Present With Us

Database Name
Politically Exposed Person
UN Sanctions
US Sanction List
Ministry of Home Affairs-Unlawful Activities (Prevention) Act

API details

Endpoint

POST https://api.signzy.app/api/v3/ndd/basic

POST https://api-preproduction.signzy.app/api/v3/ndd/basic

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameters	Description	Type	Value
name	Name of the individual/entity whose background check has to be done	String	Mandatory
type	Whether it is an individual or an entity	String	Mandatory (entity/individual)
category	Negative Categories List on which search has to be done Possible Values	Array	Optional
databaseList	Negative Databases List on which search has to be done	Array	Optional
matchScoreThreshold	Threshold Score up to which search has to be done	String	Optional
dateOfBirthOrIncorporation	Date of Birth/Date of Incorporation of the individual/entity	String	Optional
dateOfBirthOrIncorporationExactMatch	dateOfBirthOrIncorporationExactMatch	Boolean	Optional
identificationNumber	Identification Number of the individual/entity	String	Optional
placeOfBirth	place of birth	String	Optional
zipcode	Zipcode of the place where individual/entity resides	String	Optional
country	Name of the country where individual/entity resides	String	Optional
countryExactMatch	countryExactMatch	String	Optional
aliasArray	Alternate names of the individual/entity	Array	Optional
searchText	Specific Words on which search has to be done for the individual/entity	Array	Optional

The request should include the following data parameters:

Code Samples

curl --location 'https://api-preproduction.signzy.app/api/v3/ndd/basic' \
--header 'Authorization: <Token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "..name..",
    "type": "..type..",
    "category": ["..category.."],
    "databaseList": ["..databaseList.."],
    "matchScoreThreshold": "..matchScoreThreshold..",
    "identificationNumber": "..identificationNumber..",
    "dateOfBirthOrIncorporation": "..dateOfBirthOrIncorporation..",
    "dateOfBirthOrIncorporationExactMatch": true/false,
    "placeOfBirth": "..placeOfBirth..",
    "zipcode": "..zipcode..",
    "country": "..country..",
    "countryExactMatch": true/false,
    "searchText": ["..searchText.."],
    "aliasArray": ["..aliasArray.."]
}'

Response

The API response will contain information related to various entities and their scores. Here is an example of the expected response structure:

{
   "politicallyExposedPerson":[
      {
         "scores":{
            "nameMatch":"..nameMatch..",
            "dobMatch":"..dobMatch..",
            "countryMatch":"..countryMatch..",
            "zipcodeMatch":"..zipcodeMatch..",
            "aliasArrayMatch":[
               "..aliasArrayMatch.."
            ],
            "identificationNumberMatch":"..identificationNumberMatch..",
            "searchTextMatch":[
               "..searchTextMatch.."
            ]
         },
         "details":{
            "code":"..code..",
            "name":"..name..",
            "history":[
               {
                  "regulatoryAction":"..regulatoryAction..",
                  "furtherDevelopments":"..furtherDevelopments..",
                  "competentAuthority":"..competentAuthority..",
                  "name":"..name..",
                  "regulatoryCharges":"..regulatoryCharges.."
               }
            ],
            "persons":[
               {
                  "regulatoryAction":"..regulatoryAction..",
                  "furtherDevelopments":"..furtherDevelopments..",
                  "competentAuthority":"..competentAuthority..",
                  "name":"..name..",
                  "regulatoryCharges":"..regulatoryCharges.."
               }
            ]
         },
         "relevance":[
            "..relevance.."
         ],
         "overallScore":"..overallScore.."
      }
   ],
   "UNSanctions":[
      {
         "scores":{
            "nameMatch":"..nameMatch..",
            "dobMatch":"..dobMatch..",
            "countryMatch":"..countryMatch..",
            "zipcodeMatch":"..zipcodeMatch..",
            "aliasArrayMatch":[
               "..aliasArrayMatch.."
            ],
            "identificationNumberMatch":"..identificationNumberMatch..",
            "searchTextMatch":[
               "..searchTextMatch.."
            ]
         },
         "details":{
            "companyName":"..companyName..",
            "address":"..address..",
            "city":"..city..",
            "state":"..state..",
            "pincode":"..pincode..",
            "email":"..email..",
            "fax":"..fax.."
         },
         "relevance":[
            "..relevance.."
         ],
         "overallScore":"..overallScore.."
      }
   ],
   "SanctionList":[
      {
         "scores":{
            "nameMatch":"..nameMatch..",
            "dobMatch":"..dobMatch..",
            "countryMatch":"..countryMatch..",
            "zipcodeMatch":"..zipcodeMatch..",
            "aliasArrayMatch":[
               "..aliasArrayMatch.."
            ],
            "identificationNumberMatch":"..identificationNumberMatch..",
            "searchTextMatch":[
               "..searchTextMatch.."
            ]
         },
         "details":{
            "companyName":"..companyName..",
            "cin":"..cin..",
            "dateOfRejection":"..dateOfRejection.."
         },
         "relevance":[
            "..relevance.."
         ],
         "overallScore":"..overallScore.."
      }
   ],
   "matchStatus":"..matchStatus.."
}
}

Detailed Response parameters for one of the Database Category, Example PEP:

Property	Example Value	Description
politicallyExposedPerson	Array containing PEP details	Contains information about the politically exposed person (PEP) matched in the check.
scores	{"nameMatch": "85.00", "dobMatch": "", ...}	Provides scores for different matching criteria, such as nameMatch, dobMatch, countryMatch, zipcodeMatch, aliasArrayMatch, identificationNumberMatch, and searchTextMatch.
details	{"Family name at birth": "", "Forename ...}	Presents detailed information about the matched PEP, including various attributes like family name at birth, forename in the original script, aliases, country, date of birth (dob), government designation, and more.
relevance	["AML", "CFT", "LENDING", "NONCOMPLIANCE"]	Indicates the relevance of the matched PEP to different risk categories, such as Anti-Money Laundering (AML), Counter Financing of Terrorism (CFT), lending risks, and non-compliance risks.
overallScore	"85.00"	Represents the overall score or confidence level of the match, indicating the likelihood of the individual being a politically exposed person.
matchStatus	"Match Found"	Specifies the status of the match. In this case, it confirms that a match has been found for a politically exposed person.

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!