Descarga PDF CURP Validation API Documentation

curl -X POST "https://api.jaak.ai/api/v1/government/mx/curp/validate" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Request-Id: d99fe2d2-c0c3-4396-bd97-a502b4c30fa3" \
  -d '{
    "curp": "GAMC850815HDFRRL09",
    "require_pdf": false
  }'

curl -X POST "https://api.jaak.ai/api/v1/government/mx/curp/validate" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Request-Id: d99fe2d2-c0c3-4396-bd97-a502b4c30fa3" \
  -d '{
    "curp": "GAMC850815HDFRRL09",
    "require_pdf": true
  }'

{
  "curp": "GAMC850815HDFRRL09",
  "require_pdf": false
}

{
  "event_id": "80b21c69-79ff-4431-8447-e38c49fb006c",
  "request_id": "80b21c69-79ff-4431-8447-e38c49fb006c",
  "timestamp": "2025-12-16T16:33:34.035842343Z",
  "process_time_ms": 63,
  "state": {
    "success": true
  },
  "curp": {
    "value": "GAMC850815HDFRRL09",
    "valid": true,
    "details": {
      "cache_invalidated": false,
      "pdf_present": true,
      "pdf_required": false,
      "pdf_url": "https://storage.googleapis.com/jaak-media/xxxxx.pdf?signature=...",
      "renapo_valid": true,
      "request_id": "b26f7618-ac0b-4da8-9b35-1436dd4a7b5f",
      "service_used": "RENAPO_GRPC",
      "status_curp": "AN"
    }
  },
  "validation_details": {
    "format_valid": true,
    "structure_valid": true,
    "check_digit_valid": true,
    "business_rules_valid": true
  },
  "personal_info": {
    "birth_date": "1985-08-15",
    "birth_entity_code": "DF",
    "birth_entity_name": "CIUDAD DE MEXICO",
    "curp_components": {
      "birth_date_curp": "1985-08-15",
      "birth_entity_curp": "DF",
      "consonants": "RRL",
      "first_letter_maternal": "M",
      "first_letter_name": "C",
      "first_letter_paternal": "G",
      "first_vowel_paternal": "A",
      "gender_curp": "H",
      "homonymy": "0",
      "verification_digit": "9"
    },
    "document_data": {
      "additional_data": "{\"additional_data\":{\"claveEntidadRegistro\":\"09\",\"claveMunicipioRegistro\":\"002\"},\"supporting_document_data\":{\"anioReg\":\"1985\",\"claveEntidadRegistro\":\"09\",\"claveMunicipioRegistro\":\"002\",\"entidadRegistro\":\"CIUDAD DE MEXICO\",\"foja\":\"\",\"libro\":\"\",\"municipioRegistro\":\"AZCAPOTZALCO\",\"numActa\":\"01234\",\"tomo\":\"\"}}",
      "certificate_number": "01234",
      "foreigner_registry_number": "",
      "registration_year": "1985",
      "registry_book": "",
      "registry_entity": "CIUDAD DE MEXICO",
      "registry_entity_code": "09",
      "registry_municipality": "AZCAPOTZALCO",
      "registry_municipality_code": "002",
      "registry_page": "",
      "registry_volume": ""
    },
    "full_name": "CARLOS",
    "maternal_surname": "MARTINEZ",
    "nationality": "MEXICO",
    "paternal_surname": "GARCIA",
    "renapo_birth_date": "1985-08-15",
    "renapo_gender": "HOMBRE",
    "status_curp": "AN",
    "status_curp_code": "AN",
    "supporting_document": "1",
    "supporting_document_code": "1"
  },
  "metadata": {
    "api_version": "v1",
    "birth_entity": "CIUDAD DE MEXICO",
    "cache_invalidated": false,
    "grpc_service": "curpv1",
    "nationality": "MEXICO",
    "pdf_expires_in": "15 minutes",
    "pdf_present": true,
    "pdf_required": false,
    "pdf_url": "https://storage.googleapis.com/jaak-media/xxxxx.pdf?signature=...",
    "renapo_status": "AN",
    "service": "RENAPO_CURP_VALIDATION",
    "supporting_document": "1"
  }
}

{
  "errorCode": "INVALID_CURP_FORMAT",
  "eventId": "evt_error_xyz789",
  "message": "El CURP debe tener exactamente 18 caracteres alfanuméricos",
  "statusCode": 400
}

const validarCURPUsuario = async (curp) => {
  const response = await fetch('https://api.jaak.ai/api/v1/government/mx/curp/validate', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer TU_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ 
      curp: curp.trim().toUpperCase(), 
      require_pdf: false 
    })
  });
  
  const data = await response.json();
  
  if (data.curp.valid && data.curp.details.renapo_valid) {
    console.log('✓ CURP válido confirmado con RENAPO');
    
    // Extraer información personal verificada
    return {
      curp: data.curp.value,
      nombreCompleto: `${data.personal_info.full_name} ${data.personal_info.paternal_surname} ${data.personal_info.maternal_surname}`,
      fechaNacimiento: data.personal_info.birth_date,
      genero: data.personal_info.renapo_gender,
      estadoNacimiento: data.personal_info.birth_entity_name,
      nacionalidad: data.personal_info.nationality,
      estado: data.personal_info.status_curp,
      verificado: true
    };
  } else {
    console.log('✗ CURP inválido o no encontrado en RENAPO');
    return null;
  }
};

// Uso
const infoUsuario = await validarCURPUsuario('GAMC850815HDFRRL09');
if (infoUsuario) {
  console.log('Usuario registrado:', infoUsuario.nombreCompleto);
}

import requests
from datetime import datetime

def verificar_curp_para_kyc(curp, descargar_certificado=False):
    """
    Verificar CURP para cumplimiento KYC y opcionalmente descargar certificado
    """
    url = "https://api.jaak.ai/api/v1/government/mx/curp/validate"
    headers = {
        "Authorization": "Bearer TU_API_KEY",
        "Content-Type": "application/json"
    }
    payload = {
        "curp": curp.strip().upper(),
        "require_pdf": descargar_certificado
    }
    
    response = requests.post(url, json=payload, headers=headers)
    data = response.json()
    
    if not data["curp"]["valid"] or not data["curp"]["details"]["renapo_valid"]:
        return {"validacion_aprobada": False, "error": "CURP no válido o no encontrado en RENAPO"}
    
    # Verificar estado del CURP
    if data["personal_info"]["status_curp_code"] != "AN":
        return {
            "validacion_aprobada": False, 
            "error": f"Estado del CURP es {data['personal_info']['status_curp']} (no activo)"
        }
    
    datos_kyc = {
        "validacion_aprobada": True,
        "curp": data["curp"]["value"],
        "info_personal": {
            "nombre_completo": f"{data['personal_info']['full_name']} "
                              f"{data['personal_info']['paternal_surname']} "
                              f"{data['personal_info']['maternal_surname']}",
            "fecha_nacimiento": data["personal_info"]["birth_date"],
            "genero": data["personal_info"]["renapo_gender"],
            "lugar_nacimiento": {
                "estado": data["personal_info"]["birth_entity_name"],
                "codigo_estado": data["personal_info"]["birth_entity_code"]
            },
            "nacionalidad": data["personal_info"]["nationality"]
        },
        "info_registro": {
            "numero_acta": data["personal_info"]["document_data"]["certificate_number"],
            "anio_registro": data["personal_info"]["document_data"]["registration_year"],
            "municipio_registro": data["personal_info"]["document_data"]["registry_municipality"]
        },
        "verificacion": {
            "validado_renapo": data["curp"]["details"]["renapo_valid"],
            "estado": data["personal_info"]["status_curp"],
            "timestamp": data["timestamp"],
            "event_id": data["event_id"]
        }
    }
    
    # Agregar URL del PDF si fue solicitado
    if descargar_certificado and data["curp"]["details"]["pdf_present"]:
        datos_kyc["url_certificado"] = data["curp"]["details"]["pdf_url"]
        datos_kyc["certificado_expira"] = "15 minutos"
    
    return datos_kyc

# Uso
resultado = verificar_curp_para_kyc('GAMC850815HDFRRL09', descargar_certificado=True)
if resultado["validacion_aprobada"]:
    print(f"✓ KYC Aprobado: {resultado['info_personal']['nombre_completo']}")
    print(f"  Fecha de Nacimiento: {resultado['info_personal']['fecha_nacimiento']}")
    print(f"  Certificado: {resultado.get('url_certificado', 'No solicitado')}")
else:
    print(f"✗ KYC Rechazado: {resultado['error']}")

const validarCURPsPorLote = async (listaCurps) => {
  const resultados = await Promise.all(
    listaCurps.map(async curp => {
      try {
        const response = await fetch('https://api.jaak.ai/api/v1/government/mx/curp/validate', {
          method: 'POST',
          headers: {
            'Authorization': 'Bearer TU_API_KEY',
            'Content-Type': 'application/json'
          },
          body: JSON.stringify({ curp, require_pdf: false })
        });
        
        const data = await response.json();
        
        return {
          curp: curp,
          valido: data.curp?.valid || false,
          validado_renapo: data.curp?.details?.renapo_valid || false,
          estado: data.personal_info?.status_curp || 'DESCONOCIDO',
          verificaciones: {
            formato: data.validation_details?.format_valid,
            estructura: data.validation_details?.structure_valid,
            digito_verificador: data.validation_details?.check_digit_valid,
            reglas_negocio: data.validation_details?.business_rules_valid
          },
          datos_personales: data.curp?.valid ? {
            nombre: data.personal_info?.full_name,
            fecha_nacimiento: data.personal_info?.birth_date,
            estado: data.personal_info?.birth_entity_name
          } : null,
          tiempo_proceso_ms: data.process_time_ms
        };
      } catch (error) {
        return {
          curp: curp,
          valido: false,
          error: error.message
        };
      }
    })
  );
  
  // Generar resumen
  const resumen = {
    total: resultados.length,
    validos: resultados.filter(r => r.valido && r.validado_renapo).length,
    invalidos: resultados.filter(r => !r.valido).length,
    no_en_renapo: resultados.filter(r => r.valido && !r.validado_renapo).length,
    tiempo_promedio_ms: resultados.reduce((acc, r) => acc + (r.tiempo_proceso_ms || 0), 0) / resultados.length
  };
  
  return { resultados, resumen };
};

// Uso
const curps = [
  'GAMC850815HDFRRL09',
  'ROML901225HDFMZS08',
  'CURP_INVALIDO_123'
];

const { resultados, resumen } = await validarCURPsPorLote(curps);
console.log(`Validados ${resumen.total} CURPs: ${resumen.validos} válidos, ${resumen.invalidos} inválidos`);
console.log(`Tiempo promedio de procesamiento: ${resumen.tiempo_promedio_ms.toFixed(0)}ms`);

resultados.forEach(resultado => {
  console.log(`${resultado.curp}: ${resultado.valido ? '✓ Válido' : '✗ Inválido'} 
    ${resultado.validado_renapo ? '(Confirmado RENAPO)' : ''}`);
});

import requests

def descargar_certificado_curp(curp, ruta_guardado="certificado_curp.pdf"):
    """
    Validar CURP y descargar certificado oficial
    """
    url = "https://api.jaak.ai/api/v1/government/mx/curp/validate"
    headers = {
        "Authorization": "Bearer TU_API_KEY",
        "Content-Type": "application/json"
    }
    payload = {
        "curp": curp.strip().upper(),
        "require_pdf": True  # Solicitar certificado PDF
    }
    
    # Paso 1: Validar y obtener URL del PDF
    response = requests.post(url, json=payload, headers=headers)
    data = response.json()
    
    if not data["curp"]["valid"]:
        return {"exito": False, "error": "CURP inválido"}
    
    if not data["curp"]["details"]["pdf_present"]:
        return {"exito": False, "error": "PDF no disponible para este CURP"}
    
    url_pdf = data["curp"]["details"]["pdf_url"]
    
    # Paso 2: Descargar PDF desde URL firmada (expira en 15 minutos)
    respuesta_pdf = requests.get(url_pdf)
    
    if respuesta_pdf.status_code == 200:
        with open(ruta_guardado, 'wb') as f:
            f.write(respuesta_pdf.content)
        
        return {
            "exito": True,
            "curp": data["curp"]["value"],
            "ruta_archivo": ruta_guardado,
            "expira_en": data["metadata"]["pdf_expires_in"],
            "nombre_titular": f"{data['personal_info']['full_name']} "
                             f"{data['personal_info']['paternal_surname']} "
                             f"{data['personal_info']['maternal_surname']}"
        }
    else:
        return {"exito": False, "error": f"Falló la descarga del PDF: {respuesta_pdf.status_code}"}

# Uso
resultado = descargar_certificado_curp('GAMC850815HDFRRL09')
if resultado["exito"]:
    print(f"✓ Certificado descargado para {resultado['nombre_titular']}")
    print(f"  Guardado en: {resultado['ruta_archivo']}")
    print(f"  La URL expira en: {resultado['expira_en']}")
else:
    print(f"✗ Error: {resultado['error']}")

try {
  const respuesta = await validarCURP(curp);
  if (!respuesta.curp.valid) {
    // Manejar CURP inválido
    const verificacionesFallidas = Object.entries(respuesta.validation_details)
      .filter(([clave, valor]) => !valor)
      .map(([clave]) => clave);
    console.log('Verificaciones fallidas:', verificacionesFallidas);
  }
} catch (error) {
  console.error('Error de API:', error);
  // Implementar lógica de respaldo o reintento
}

const requestId = `curp_validation_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;

const cache = new Map();

const validarConCache = async (curp) => {
  if (cache.has(curp)) {
    return cache.get(curp);
  }
  
  const resultado = await validarCURP(curp);
  if (resultado.curp.valid) {
    cache.set(curp, resultado);
  }
  
  return resultado;
};