Service Documentation: "AMLRISK Search"

Welcome to AMLRISK. This application is designed for performing searches on natural or legal persons in globally recognized binding and risk-related lists. This document describes how to consume the REST protocol WebService for mass searches.

Service Overview

Request Parameters

Request Headers

Request Body

You should send a JSON object with the data of the persons you want to query. It's not necessary for all fields to be present, but it is recommended to include both the name and the identification number as they appear on the official document.

Request Body Example

{
  "Name": "[Full_Name]",
  "Identification": "[Identification_Number]",
  "SearchJudicialBranch": false,
  "SearchProcuration": false
}

Replace placeholder values (e.g., your_api_key, unique_customer_id, etc.) with actual data relevant to your verification process.

Example CURL Request

curl --location 'https://btrust-api.ado-tech.com/prod/aml' \
--header 'projectName: [Your_Project_Name]' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: [Your_API_Key]' \
--data '{
  "Name": "[Full_Name]",
  "Identification": "[Identification_Number]",
  "SearchtJudicialBranch": false,
  "SearchProcuration": false
}'

Replace placeholder values (e.g., [Full_Name], [Identification_Number], etc.) with actual data relevant to your verification process.

Response Structure for "Create Process" Service

Upon making a request to the "Create Process" service, the server will respond with a status code indicating the outcome of the request. Below are the possible responses you might receive:

Successful Response

{
  "datetime": "2021-11-25 16:19:50",
  "id_bitacora": 4609695,
  "results": [
    {
      "item_no": 2,
      "nombre": "Miguel Angel Orejuela",
      "doc_id": "98563386",
      "block": true,
      "datos_pro": null,
      "datos_ramajudicial": null,
      "datos_amlnews": [],
      "datos_tsti": [
        {
          "lista": ["5349"],
          "estado": null,
          "categoria": ["Barequeros"],
          "nombre_apellido": ["MIGUEL ANGEL OREJUELA MARTINEZ"],
          "url": "https://tramites.anm.gov.co/Portal/pages/consultaListados/anonimoListados.jsf",
          "pais": ["COLOMBIA"],
          "detalle": ["Registro Único de Comercializadores de Minerales RUCOM, de la Agencia Nacional de Minería contiene la relación de personas naturales y jurídicas registradas como barequeros o comerciantes de Minerales"],
          "id": "1378617",
          "nombre_relacion_lista": ["Agencia Nacional de Minería RUCOM."],
          "id_relacion_lista": ["154"],
          "_version_": 1715704460641042432,
          "estado1": null,
          "estado2": null,
          "estado3": null,
          "relacionado": "[]"
        },
        {
          "lista": ["2776"],
          "estado": null,
          "categoria": ["SDNTK"],
          "nombre_apellido": ["DIAZ OREJUELA, Miguel Angel"],
          "pasaporte2": ["AI481119"],
          "url": "http://bit.ly/1MLgpye ,http://bit.ly/1I7ipyR",
          "detalle": ["Specially Designated Nationals (SDN) - Treasury Department"],
          "pasaporte": ["AI481119"],
          "n_identificacion2": ["17412428"],
          "ciudadania": ["CO"],
          "alias": [""],
          "id": "1726895",
          "n_identificacion": ["17412428"],
          "nombre_relacion_lista": ["BIS"],
          "id_relacion_lista": ["352"],
          "_version_": 1715704497073815552,
          "estado1": null,
          "estado2": null,
          "estado3": null,
          "relacionado": "[]"
        }
      ],
      "datos_twitter": null
    }
  ],
  "elapsed_time": 0.15829205513
}

Explanation of the Response Structure

Client Error Response

{
  "Bad Request": "The provided data does not meet the expected criteria."
}

Unauthorized Error Response

{
  "Unauthorized": "Invalid API key or insufficient permissions."
}

Server Error Response

{
  "Internal Server Error": "An error occurred on the server."
}

Description: This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. It is a generic error message, implying that the issue lies with the server rather than the request itself.

Implementation Notes

These implementation notes are crucial for understanding the operational scope and limitations of the AMLRISK Search Service, ensuring that users can properly integrate and utilize the service within their systems.


Revision #2
Created 10 May 2024 21:09:03 by Admin
Updated 10 May 2024 23:19:16 by Admin