Verificaciones en tiempo real desde tus sistemas
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 Advantage.
- 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 sobre el 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.
- ✓Acceso inicial gratuito para consultas automatizadas
- ✓Listas internacionales consolidadas y actualizadas
- ✓Verifica desde tus sistemas y evalúa sin contratos