Referencia completa de todos los códigos de error de la API de Valida-CURP.
Cuando error es true en la respuesta, el campo code_error indica qué salió mal.
{
"error": true,
"code_error": 101,
"error_message": "Estructura CURP inválida",
"response": null
}Estos errores pueden ocurrir en cualquier petición, independientemente del endpoint.
| Código | Mensaje | Causa | Solución |
|---|---|---|---|
1 | IP/token bloqueado | Tu IP o token fue bloqueado por incumplimiento de términos | Contacta soporte |
2 | Token inválido | El token no existe o fue revocado | Verifica el token en el panel |
3 | Proyecto suspendido | El proyecto asociado está suspendido | Reactiva el proyecto en el panel |
4 | Consultas agotadas | Llegaste al límite de tu plan | Adquiere más consultas |
/validar| Código | Mensaje | Causa |
|---|---|---|
100 | CURP no recibido | Falta el parámetro curp |
101 | Estructura CURP inválida | El CURP no cumple el formato de 18 caracteres |
/obtener_datos| Código | Mensaje | Causa |
|---|---|---|
200 | Error de conexión con RENAPO | RENAPO no está disponible temporalmente |
300 | Error interno de RENAPO | RENAPO devolvió un error inesperado |
Los errores
200y300son transitorios — reintenta la petición después de unos segundos.
/calcular_curp| Código | Parámetro faltante |
|---|---|
400 | nombres |
401 | apellido_paterno |
402 | apellido_materno |
403 | anio_nacimiento |
404 | mes_nacimiento |
405 | dia_nacimiento |
406 | sexo |
407 | entidad |
| Código | Descripción |
|---|---|
408 | anio_nacimiento no es numérico |
409 | mes_nacimiento no es numérico |
410 | dia_nacimiento no es numérico |
411 | entidad no es numérico |
412 | anio_nacimiento debe tener exactamente 4 dígitos |
413 | mes_nacimiento debe tener exactamente 2 dígitos |
414 | dia_nacimiento debe tener exactamente 2 dígitos |
415 | entidad debe tener exactamente 2 dígitos |
416 | sexo inválido — usa H, M o X |
417 | Error inesperado en el cálculo |
Cuando code_error es 0, la petición fue exitosa.
{
"error": false,
"code_error": 0,
"error_message": null,
"response": { }
}const data = await response.json();
if (data.error) {
switch (data.code_error) {
case 2:
console.error("Token inválido — verifica tu configuración");
break;
case 4:
console.error("Consultas agotadas — adquiere más en el panel");
break;
case 101:
console.error("CURP con estructura incorrecta"