api

Listas Oficiales JAAK

Descripción

API de Listas Oficiales de JAAK que permite consultas de verificación contra bases de datos del gobierno mexicano y organizaciones internacionales, esencial para procesos KYC y verificación de identidad.

Endpoints

AmbienteURL
SandboxPOST https://sandbox.api.jaak.ai/api/v2/blacklist/investigate
ProducciónPOST https://services.api.jaak.ai/api/v2/blacklist/investigate

Servicios Soportados

1. Servicio CURP

Valida registros del registro de población mexicano (RENAPO). Retorna datos personales incluyendo nombre, fecha de nacimiento, género, lugar de nacimiento y detalles de registro.

2. Servicio INE

Verifica autenticidad de credencial electoral usando números CIC (9 dígitos) y OCR (13 dígitos). Retorna estado de validación.

3. Servicio OFAC

Consulta listas de sanciones del Tesoro de EE.UU. para individuos involucrados en narcóticos, terrorismo o proliferación de armas.

4. Servicio SAT69B

Verifica si el RFC aparece en la lista negativa del SAT por operaciones fraudulentas.

5. Servicio INTERPOL

Busca en listas internacionales de personas buscadas en todos los tipos de alertas.

Interpretación de Resultados

ServiciofoundInService: truefoundInService: false
CURPRegistro válido ✅Inválido/No encontrado ❌
INECredencial válida ✅Credencial inválida ❌
OFACPersona sancionada ❌No sancionada ✅
SAT69BRFC en lista ❌No listado ✅
INTERPOLPersona buscada ❌No buscada ✅

Límites de Rate

AmbienteLímite
Sandbox100 solicitudes/minuto
ProducciónSegún plan contratado

Otras restricciones:

  • Tamaño máximo de solicitud: 1 MB
  • Timeout de solicitud: 30 segundos

Mejores Prácticas

  • Usar UUIDs únicos para seguimiento de eventId
  • Implementar backoff exponencial para errores 5xx
  • Nunca exponer tokens de API en frontend
  • Almacenar tokens en variables de entorno
  • Cachear consultas repetidas de CURP/INE
  • Monitorear tiempos de respuesta

Códigos HTTP

CódigoDescripción
200Éxito
400Parámetros inválidos
401Fallo de autenticación
403Permisos insuficientes
429Rate limit excedido
500Error del servidor