Skip to main content

AML Database

Download our comprehensive database.

The dilisense AML Database provides you with access to the dilisense consolidated file which includes a myriad of sanction, PEP, criminal watch lists and additional sources. All sources are listed on our website (https://dilisense.com). The file can be downloaded via API in JSON format. The API call has to be made via HTTPS request.

1. Authentication​

All API calls to dilisense require an authentication via API key. Specifically we expect the x-api-key value to be set in the header of your API call. If the API key is not valid, the API call will return a 401 HTTP error code.

We will provide you with a private API key, which you can use for downloading the consolidated file via API. The private API key is only intended for your own use, as we track the number of API calls with this key. The key has to be securely stored on your side to avoid any misuse by unauthorized parties.

2. downloadConsolidatedFile (GET)​

The downloadConsolidatedFile API method returns a unique link that becomes invalid once opened or after 5 minutes of issuing. It is formatted as JSON Lines and consists of the same attributes (using camelCase instead of snake_case) as described in the API Check service.

Endpoint​

https://api.dilisense.com/v1/downloadConsolidatedFile

Request parameters​

There are no request parameters to be provided.

Response​

The response provided back is formatted as JSON.

timestamp (string)​

The timestamp of the response (Unix timestamp in milliseconds).

url (string)​

The URL from which the consolidated file can be downloaded.

Example​

Request​

curl --location --request GET 'https://api.dilisense.com/v1/downloadConsolidatedFile' \
--header 'x-api-key: <api_key>'

Response​

{
    "timestamp": "1712772611979",
    "url": "https://site-api.dilisense.com/v1/getConsolidatedFile?api_key=<api_key>"
}

Consolidated file​

{"sourceId":"eu_financial_sanction_list","sourceType":"SANCTION","id":"9a485b46f9ff6af5","entityType":"INDIVIDUAL","gender":"MALE","name":"Hodjatoleslam SOLTANI","lastNames":["SOLTANI"],"aliasNames":["Hodjatoleslam Seyed Mohammad SOLTANI"],"givenNames":["Hodjatoleslam","Seyed Mohammad"],"sanctionDetails":["2020-04-08","IRN"],"functions":["Head of the Organisation for Islamic Propaganda in the province of Khorasan-Razavi. Judge, Mashhad Revolutionary Court until 2013."]}
{"sourceId":"us_occ_enforcement_actions_sanction_list","sourceType":"SANCTION","id":"9a12cb46f9ff6af5","entityType":"ENTITY","name":"First Fidelity Trust, National Association, Florida","address":["Boca Raton, Florida (FL), USA"],"jurisdiction":["USA"],"sanctionDetails":["Civil Money Penalty (CMP) for details see: https://www.occ.gov/topics/laws-regulations/enforcement-actions/enforcement-actions-types.html","Start date: 8/5/1991"]}
{"sourceId":"in_interpol_most_wanted_list","sourceType":"CRIMINAL","id":"9a18cb49f9ff6af5","entityType":"INDIVIDUAL","gender":"MALE","name":"TASAWAR IQBAL","lastNames":["IQBAL"],"givenNames":["TASAWAR"],"dateOfBirth":["07/09/1981"],"placeOfBirth":["Pakistan","Gujrat"],"citizenship":["Pakistan"],"sanctionDetails":["Issuing country: Pakistan","Charge: Murder"],"links":["https://www.interpol.int/en/How-we-work/Notices/View-Red-Notices#2018-14069"],"otherInformation":["Weight: 65 kg","Height: 1.72 m","Language spoken: Panjabi","Language spoken: Urdu","Eye color: BLA","Hair color: BLA"]}
{"sourceId":"ru_ffms_terrorist_list","sourceType":"SANCTION","id":"ca18hb46f9ff6af5","entityType":"ENTITY","name":"МЕСТНАЯ РЕЛИГИОЗНАЯ ОРГАНИЗАЦИЯ СВИДЕТЕЛЕЙ ИЕГОВЫ Г.НИЖНЕКАМСКА И НИЖНЕКАМСКОГО РАЙОНА \"УПРАВЛЕНЧЕСКОГО ЦЕНТРА СВИДЕТЕЛЕЙ ИЕГОВЫ В РОССИИ\"","companyNumber":["ИНН: 1651024363;"]}
{"sourceId":"fr_tresor_registre_national_des_gels_sanction_list","sourceType":"SANCTION","id":"9a18cp46f9ff6af5","entityType":"ENTITY","name":"Med Wave Shipping","sanctionDetails":["Regime de sanction ou de gel national concerne: Libye \n(UE Annexe III)","Fondement juridique: 2016/44 18/01/2016","Arrete d\u0027extension de la mesure aux PTOM: arrêté ECOT2025028A du 21/09/2020","Lien utile: https://www.tresor.economie.gouv.fr/services-aux-entreprises/sanctions-economiques","Date d\u0027ajout au registre: 9/21/20"],"otherInformation":["Adresse: Office 511, 5th Floor, Baraka Building, Dauwar Al-Waha, Jordanie;","Adel Al-Hojrat building n°3, 1st Floor, opposite Swefieh, Mall-Swefieh Po Box 850880 Amman, 11185 Jordanie;","Ground Floor, Orient Queen Homes Building, Liban","Tél. +962787064121; +96265865550; +96265868550","Courriel: operation@medwave.co","compagnie maritime qui exploite le navire Bana dont il a été établie qu’il a violé l’embargo sur les armes imposé à la Libye par la résolution 1970 (2011) du Conseil de sécurité des Nations unies et transposé à l’article 1er de la décision (PESC) 2015/1333. Le Bana a en particulier été lié à des transports de matériel militaire vers la Libye en janvier 2020.","Désigné par le règlement (UE) 2020/1309 du 21/09/2020"]}
{"sourceId":"dilisense_pep","sourceType":"PEP","id":"9a18cb46f9of6af5","pepType":"POLITICIAN","entityType":"INDIVIDUAL","gender":"MALE","name":"Joël Bruneau","lastNames":["Bruneau"],"givenNames":["Joël"],"dateOfBirth":["07/09/1963"],"placeOfBirth":["Châteauroux"],"citizenship":["France"],"description":["French politician"],"occupations":["board member","politician","professions libérales et assimilés"],"positions":["2014-03-30 - 2020-05-17  conseiller municipal de Caen","2014-04-05 - 2020-05-22  mayor of Caen","Since 2017-01-01  conseiller communautaire de Caen la Mer","Since 2020-05-18  conseiller municipal de Caen","Since 2020-05-23  mayor of Caen","conseiller régional de Basse-Normandie"],"politicalParties":["Union for a Popular Movement"],"links":["Facebook: joel.bruneau.50"]}

The data in the example above is test data to illustrate the json lines response. Any similarity to actual persons, living or dead, is purely coincidental.

3. Versioning​

The API versioning will be incremental starting from v1. Only if there are breaking changes, we will increase the version to v2 and higher. We reserve the right to introduce new functionalities at any time which are not considered breaking the current API request / response logic.

Once a new API version is available, you will be notified. However you can still use the old API version for at least 12 months before we stop supporting the old version.

4. Usage Limits​

You can download the consolidated file up to 50 times a day.

5. Errors​

The dilisense API adheres to the regular HTTP error codes. This means that codes in the 2xx range indicate a successful API call, codes in the range of 4xx indicate an error on the client side (e.g. failed authentication) and codes in the 5xx range inform you about an error with the dilisense servers.

The detailed error codes are: 200 - OK - The request was successful. 400 - Bad Request - The request was incorrect. 401 - Unauthorized - The API key was not valid. 403 - Forbidden - The URL is not accessible. 500 - Internal Server Error - An internal error occurred.

There is a detailed error message (JSON) available for each of the error responses, for example:

"{"error_message": "Error text."}"