AMLAdvantage-DevConnect

Tu acceso gratuito a la API de verificación de listas de sanciones internacionales

AMLAdvantage-DevConnect es nuestra API gratuita, diseñada para facilitar la integración de la verificación de listas de sanciones internacionales (OFAC, ONU, UE, HMT, Canadá, entre otras) en cualquier sistema. Este acceso está diseñado para entornos de evaluación o desarrollo, sin necesidad de contratar un plan comercial.

Ideal para quienes quieren:

Validar una integración técnica.
Probar la funcionalidad del sistema antes de contratarlo.
Construir un flujo automatizado de verificación de listas.

¿Qué necesitas para comenzar?

🔑 1. Crea tu cuenta

Ingresa a: https://aml-advantage.com/aml/inicio/registro
Completa el formulario de registro con tu información institucional y selecciona el tipo de acceso solicitado: Acceso API – DevConnect
Acepta los términos y condiciones para la creación del usuario.

🛡️ Validación de tu solicitud

Una vez enviado el formulario:

Tu solicitud será revisada manualmente por el equipo de AML Consulting.
El hecho de enviar el formulario no garantiza el acceso automático.
Solo se procesarán solicitudes con correos institucionales válidos.
En algunos casos, podremos solicitar información adicional para validar la identidad o finalidad del acceso.
El proceso de validación puede tomar hasta 48 horas hábiles.
Recibirás una notificación por correo una vez tu cuenta haya sido activada.

🛠 2. Genera tu API Key

Inicia sesión en el sistema con las credenciales registradas en tu solicitud.
Ve al menú “Developers” > “API Key”.
Presiona el botón “Crear API Key”.
Copia tu clave y guárdala. La necesitarás en todas las consultas.

🔗 Tu API Key está lista.
Sigue con la integración utilizando nuestra documentación técnica oficial.
Accede al endpoint, revisa los parámetros y conecta tu sistema de forma segura y controlada.

Documentación técnica

Método del Endpoint

Elemento	Valor
Métodos	GET y POST
URL base	`https://aml-advantage.com/aml/devconnect/api`
Endpoint	`/consultalistas`
URL completa	`https://aml-advantage.com/aml/devconnect/api/consultalistas`
Autenticación	Mediante encabezado `X-API-KEY` con tu clave personal

Encabezado obligatorio

				
					X-API-KEY: TU_API_KEY_GENERADA

Parámetros permitidos

Debes enviar al menos uno de los siguientes tres parámetros. Puedes combinarlos para mejores resultados.

Parámetro	Tipo	Requerido	Descripción
nombres	string	Opcional	Nombres o razón social (empresa)
apellidos	string	Opcional	Apellidos (si es persona natural)
nombre_completo	string	Opcional	Nombre completo de persona natural
documento	string	Opcional	Documento de identidad

Nota:

Solo nombres → se asume persona jurídica
nombres + apellidos → se asume persona natural
nombre_completo → parámetro opcional, para búsqueda de persona natural por nombre completo
Si no envías ningún campo, obtendrás un error 400

Ejemplo de consulta (cURL)

				
					curl -X POST https://aml-advantage.com/aml/devconnect/api/consultalistas \
-H "X-API-KEY: TU_API_KEY_AQUI" \
-d "nombres=Juan&apellidos=Pérez"

Ejemplo de respuesta exitosa (200 OK)

				
					{
  "status": true,
  "message": "Transacción Exitosa",
  "datos": [
    {
      "nombres": "Juan",
      "apellidos": "Perez",
      "nombre_empresa": "",
      "tipo": "física",
      "ref": "",
      "no_documento": "",
      "nombre_lista": "Lista de Cautela",
      "porcentaje_coincidencia": 81.83,
      "informacion_registro": "Edad: 21 / Nacionalidad: Salvadoreña / 
          Pais de domicilio: El Salvador / Informacion: Acusado 
          por el delito de posesión y tenencia de droga."
    }
  ],
  "num_registros": 1
}

Nota: Campo informacion_registro.

Devuelve un string con múltiples atributos del registro concatenados.
Cada atributo está delimitado por el separador » / « (espacio-pleca-espacio).
La información está estructurada como pares clave: valor.

Códigos de respuesta y errores comunes

Código HTTP	Error	Causa
200 – OK	message y datos	Consulta realizada con éxito
400 – Bad Request	Debe ingresar al menos uno de los parámetros	No se enviaron nombres, apellidos ni documento
401 – Unauthorized	API Key no proporcionada	No se incluyó el encabezado X-API-KEY
403 – Forbidden	API Key inválida	La API Key no existe o es inválida
403 – Forbidden	El usuario solo tiene permiso vía Sitio Web	El usuario no tiene acceso por Web Service
403 – Forbidden	Su usuario no tiene el estado requerido	El estado del usuario no permite realizar búsquedas
404 – Not Found	Usuario no encontrado	El ID de usuario asociado a la API Key no existe en la base de datos
429 – Too Many Requests	Búsqueda no realizada por superar el límite permitido	El usuario ha superado su límite de búsquedas permitidas

¿Qué incluye?

✅ Consultas solo a listas internacionales (OFAC, ONU, UE, etc.)
✅ Hasta 50 consultas mensuales
✅ Respuesta básica: nombres, listas, porcentaje de coincidencia
✅ Acceso a documentación técnica y ejemplos
✅ Acceso gratuito por 6 meses (renovable bajo evaluación)

¿Qué no incluye?

❌ No incluye acceso a listas de cautela ni PEP
❌ No muestra perfiles detallados ni enlaces
❌ No permite descargas ni visualización desde la plataforma web
❌ No incluye almacenamiento de logs de consulta
❌ Sin soporte técnico personalizado

Solicita tu acceso ahora

¿Listo para probar cómo funciona nuestra API?

🔐 Crea tu cuenta, genera tu clave y comienza a verificar desde tu entorno.

Explora cómo funciona nuestra API y evalúa su integración con tus procesos.

Integración API

AMLAdvantage-DevConnect