> ## Documentation Index > Fetch the complete documentation index at: https://docs.enrow.io/llms.txt > Use this file to discover all available pages before exploring further. # Códigos de estado > Referencia de los códigos de estado HTTP de la API de Enrow y los valores de calificación de búsqueda, para que sepas cómo gestionar cada respuesta La API de Enrow utiliza códigos de estado HTTP estándar para indicar el resultado de cada solicitud, además de un campo `qualification` que indica el resultado de una búsqueda o verificación. Esta página enumera todos los códigos y valores de calificación para que puedas gestionar las respuestas de forma fiable. Para los mensajes de error correspondientes y los formatos de respuesta, consulta [Gestión de errores](/es/error-handling). ## ¿Qué códigos de estado HTTP devuelve la API? La API de Enrow utiliza códigos de estado HTTP estándar para indicar el resultado de cada solicitud. Un código `2xx` significa que la solicitud se realizó correctamente, un código `4xx` indica un problema con la solicitud y un código `5xx` significa que algo salió mal por parte de Enrow. ### ¿Qué códigos indican éxito? Un código de estado `2xx` significa que la API aceptó la solicitud. Las operaciones asíncronas (como las búsquedas masivas) devuelven `201` o `202` porque el trabajo continúa en segundo plano. | Código | Significado | Descripción | | ------- | ----------- | ---------------------------------------------------------------- | | **200** | OK | La solicitud se realizó correctamente, se devolvieron resultados | | **201** | Created | Recurso creado (p. ej., búsqueda masiva iniciada) | | **202** | Accepted | Solicitud aceptada, procesamiento asíncrono | ### ¿Qué códigos indican que la solicitud fue rechazada? Un código de estado `4xx` significa que la API rechazó la solicitud debido a algo que se puede corregir en el lado del cliente: parámetros no válidos, una clave de API ausente o no válida, créditos insuficientes o demasiadas solicitudes. | Código | Significado | Descripción | | ------- | ----------------- | --------------------------------- | | **400** | Bad Request | Parámetros no válidos o ausentes | | **401** | Unauthorized | Clave de API no válida o ausente | | **402** | Payment Required | Créditos insuficientes | | **429** | Too Many Requests | Se superó el límite de frecuencia | Un `401` significa que la clave de API está ausente o no es válida; consulta [Autenticación](/es/authentication) para saber cómo enviarla correctamente. Un `402` significa que la cuenta se ha quedado sin créditos; revisa el consumo en [Créditos y facturación](/es/credits-billing). Un `429` significa que la solicitud superó el rendimiento permitido; consulta [Límites de frecuencia](/es/rate-limits) para entender los umbrales. La API nunca devuelve **404**. Un ID de búsqueda desconocido o caducado devuelve **400** para los endpoints masivos y **500** para los endpoints individuales. ### ¿Qué códigos indican un error del servidor? Un código de estado `5xx` significa que la solicitud era válida, pero algo salió mal por parte de Enrow. Estas respuestas se pueden reintentar de forma segura tras un breve retraso. | Código | Significado | Descripción | | ------- | --------------------- | ------------------------------ | | **500** | Internal Server Error | Algo salió mal de nuestro lado | ## ¿Qué son las calificaciones de búsqueda? Una calificación de búsqueda es el valor del campo `qualification` que indica el resultado de una búsqueda o verificación. Enrow devuelve este campo en todos los endpoints, y el resultado siempre es **binario**: no hay un "quizás" ni una puntuación de probabilidad. Es una decisión de diseño deliberada. ### ¿Por qué el resultado es binario? El resultado es binario porque una respuesta clara de sí o no es más fácil de gestionar que una probabilidad. La mayoría de las herramientas de enriquecimiento devuelven un conjunto complejo de categorías (catch-all, riesgoso, desconocido, no verificable, etc.) que te obligan a construir lógica en torno a probabilidades. Enrow adoptó el enfoque opuesto: * **Enrow verifica incluso los correos catch-all de forma determinista**, por lo que no es necesaria una categoría "catch-all" * Enrow no cree en sistemas probabilísticos con docenas de clasificaciones: añaden complejidad sin aportar claridad * Un resultado binario significa que puedes actuar sobre los datos de inmediato sin tener que dudar El resultado es bueno o no lo es. Así de simple. ### ¿Qué calificaciones devuelve Email Finder? El [Email Finder](/es/api-reference/email-finder/find-single) devuelve uno de los siguientes valores en el campo `qualification`: | Calificación | Significado | | ------------ | ------------------------------ | | `valid` | Correo encontrado y verificado | | `invalid` | Correo no encontrado | | `ongoing` | Búsqueda aún en curso | ### ¿Qué calificaciones devuelve Email Verifier? El [Email Verifier](/es/api-reference/email-verifier/verify-single) devuelve uno de los siguientes valores en el campo `qualification`: | Calificación | Significado | | ------------ | ------------------------------------- | | `valid` | El correo es válido y entregable | | `invalid` | El correo es inválido o no entregable | | `ongoing` | Verificación aún en curso | `invalid` significa cosas distintas según el endpoint: en el **Email Finder**, significa que el correo no se encontró. En el **Email Verifier**, significa que el correo existe pero no es entregable. ### ¿Qué calificaciones devuelve Phone Finder? El [Phone Finder](/es/api-reference/phone/find-single) devuelve uno de los siguientes valores en el campo `qualification`: | Calificación | Significado | | ------------ | ------------------------------------------- | | `found` | Número de teléfono localizado correctamente | | `not_found` | No se pudo encontrar el número de teléfono | | `ongoing` | Búsqueda aún en curso | ### ¿Cómo hago el seguimiento de una búsqueda masiva? Para las operaciones masivas, un campo `status` indica el progreso del lote. Sondea el endpoint GET correspondiente ([resultados masivos de Email Finder](/es/api-reference/email-finder/get-bulk-results), [verificaciones masivas de Email Verifier](/es/api-reference/email-verifier/get-bulk-verifications) o [resultados masivos de Phone Finder](/es/api-reference/phone/get-bulk-results)) hasta que el `status` sea `completed`. | Estado | Significado | | ----------- | ------------------------------------------- | | `ongoing` | El lote sigue procesándose | | `completed` | Todas las búsquedas del lote han finalizado | | `failed` | El lote falló | ## FAQ Un `401 Unauthorized` significa que la clave de API está ausente o no es válida. Asegúrate de que cada solicitud incluya una clave válida en la cabecera `x-api-key`. Consulta [Autenticación](/es/authentication) para más detalles. Un `402 Payment Required` significa que la cuenta no tiene créditos suficientes para completar la solicitud. Recarga o revisa cómo se consumen los créditos por endpoint en [Créditos y facturación](/es/credits-billing). La API de Enrow nunca devuelve `404`. Un ID de búsqueda desconocido o caducado devuelve `400` para los endpoints masivos y `500` para los endpoints individuales. Vuelve a comprobar el `id` devuelto cuando se inició la búsqueda. No. `ongoing` significa que la búsqueda o verificación aún está en curso. Vuelve a sondear el endpoint GET tras un breve retraso, o usa un webhook para recibir una notificación automática cuando finalice; consulta [Cómo funcionan los webhooks](/es/how-webhooks-work). ## Próximos pasos Consulta los mensajes de error completos y los formatos de respuesta para cada código de estado. Envía tu clave de API en la cabecera x-api-key para evitar errores 401. Comprende los umbrales que activan una respuesta 429. Consulta cómo se consumen los créditos y evita errores 402.