Consultas oficiales
Las APIs de consultas oficiales validan datos de identidad y antecedentes contra fuentes autoritativas del gobierno mexicano y listas internacionales de cumplimiento (PLD/AML). A diferencia de la verificación KYC integral, estas son consultas atómicas que puedes invocar directamente sin necesidad de iniciar una sesión.
¿Cuándo usar consultas oficiales?
Si necesitas validar un dato puntual (un RFC, un CURP, una persona contra listas) y ya tienes la información del usuario, las consultas oficiales son más rápidas y económicas que un flujo KYC completo.
APIs disponibles
| Producto | Qué valida | Endpoint |
|---|---|---|
| Listas PLD / AML | Persona contra OFAC, INTERPOL, INE, SAT 69-B, CDC | POST /api/v2/blacklist/investigate |
| INE | Imagen de credencial contra padrón electoral del INE | POST /api/v1/government/mx/ine/verify |
| SAT / RFC | Validez estructural de un RFC | POST /api/v1/government/mx/rfc/validate |
| RENAPO / CURP | CURP contra Registro Nacional de Población | POST /api/v1/official-list/mx/curp/validate |
Autenticación
Todas las consultas oficiales requieren un API Key con scope adecuado. Pasa el token como Bearer:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Si aún no tienes API Key, consulta la guía de cómo iniciar sesión en la Plataforma JAAK y la sección de Cómo consumir JAAK KYC que explica cómo generar uno desde el dashboard.
URL base
| Ambiente | URL base |
|---|---|
| Producción | https://services.api.jaak.ai |
| Sandbox | https://api.sandbox.jaak.ai |
Sandbox tiene cuotas separadas
El consumo en sandbox no afecta tu cuota de producción, pero sí tiene límites propios. Consulta Sandbox para más detalle.
Diferencia con verificación KYC
| Consultas oficiales | Verificación KYC |
|---|---|
| Una llamada HTTP atómica | Flujo de sesión con varias etapas (documento + biometría + listas) |
| El integrador provee los datos a validar | El usuario captura los datos vía SDK web/móvil |
| Sin captura de imagen ni biometría (excepto INE) | Captura de identificación + selfie + prueba de vida |
| Resultado inmediato | Resultado al finalizar la sesión |
| Útil para flujos de onboarding ligero, screening de proveedores, validación periódica | Útil para alta de cliente con KYC formal |
Si necesitas el flujo completo, ve a Verificar identidad.
Siguientes pasos
- Listas PLD / AML — el endpoint más usado para screening
- INE — valida una credencial INE contra el padrón
- SAT / RFC — valida formato y existencia de un RFC
- RENAPO / CURP — valida una CURP contra RENAPO