> ## 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 Status > Referência dos códigos de status HTTP da API Enrow e dos valores de qualificação de busca, para que você saiba como lidar com cada resposta A API Enrow usa códigos de status HTTP padrão para indicar o resultado de cada requisição, além de um campo `qualification` que informa o resultado de uma busca ou verificação. Esta página lista todos os códigos e valores de qualificação para que você possa lidar com as respostas de forma confiável. Para as mensagens de erro correspondentes e os formatos de resposta, consulte [Tratamento de erros](/pt/error-handling). ## Quais códigos de status HTTP a API retorna? A API Enrow usa códigos de status HTTP padrão para indicar o resultado de cada requisição. Um código `2xx` significa que a requisição foi bem-sucedida, um código `4xx` aponta um problema com a requisição e um código `5xx` significa que algo deu errado do lado da Enrow. ### Quais códigos significam sucesso? Um código de status `2xx` significa que a API aceitou a requisição. Operações assíncronas (como buscas em massa) retornam `201` ou `202` porque o trabalho continua em segundo plano. | Code | Meaning | Description | | ------- | -------- | ----------------------------------------------------- | | **200** | OK | Requisição bem-sucedida, resultados retornados | | **201** | Created | Recurso criado (por exemplo, busca em massa iniciada) | | **202** | Accepted | Requisição aceita, processamento assíncrono | ### Quais códigos significam que a requisição foi rejeitada? Um código de status `4xx` significa que a API rejeitou a requisição por causa de algo que pode ser corrigido do lado do cliente — parâmetros inválidos, uma chave de API ausente ou inválida, créditos insuficientes ou muitas requisições. | Code | Meaning | Description | | ------- | ----------------- | -------------------------------- | | **400** | Bad Request | Parâmetros inválidos ou ausentes | | **401** | Unauthorized | Chave de API inválida ou ausente | | **402** | Payment Required | Créditos insuficientes | | **429** | Too Many Requests | Limite de taxa excedido | Um `401` significa que a chave de API está ausente ou inválida — consulte [Autenticação](/pt/authentication) para saber como enviá-la corretamente. Um `402` significa que a conta está sem créditos; revise o consumo em [Créditos e cobrança](/pt/credits-billing). Um `429` significa que a requisição excedeu a taxa de transferência permitida — consulte [Limites de taxa](/pt/rate-limits) para entender os limites. A API nunca retorna **404**. Um ID de busca desconhecido ou expirado retorna **400** para endpoints em massa e **500** para endpoints individuais. ### Quais códigos significam um erro de servidor? Um código de status `5xx` significa que a requisição era válida, mas algo deu errado do lado da Enrow. Essas respostas podem ser repetidas com segurança após um breve intervalo. | Code | Meaning | Description | | ------- | --------------------- | ----------------------------- | | **500** | Internal Server Error | Algo deu errado do nosso lado | ## O que são qualificações de busca? Uma qualificação de busca é o valor no campo `qualification` que informa o resultado de uma busca ou verificação. A Enrow retorna esse campo em todos os endpoints, e o resultado é sempre **binário** — não há "talvez" nem pontuação de probabilidade. Essa é uma escolha de design deliberada. ### Por que o resultado é binário? O resultado é binário porque uma resposta clara de sim ou não é mais fácil de usar do que uma probabilidade. A maioria das ferramentas de enriquecimento retorna um conjunto complexo de categorias — catch-all, arriscado, desconhecido, não verificável, etc. — que obrigam você a criar lógica em torno de probabilidades. A Enrow adotou a abordagem oposta: * **A Enrow verifica de forma determinística até mesmo e-mails catch-all**, então não há necessidade de uma categoria "catch-all" * A Enrow não acredita em sistemas probabilísticos com dezenas de classificações — eles adicionam complexidade sem clareza * Um resultado binário significa que você pode agir sobre os dados imediatamente, sem ficar em dúvida O resultado é bom ou não é. Simples. ### Quais qualificações o Email Finder retorna? O [Email Finder](/pt/api-reference/email-finder/find-single) retorna um dos seguintes valores no campo `qualification`: | Qualification | Meaning | | ------------- | ------------------------------ | | `valid` | E-mail encontrado e verificado | | `invalid` | E-mail não encontrado | | `ongoing` | Busca ainda em andamento | ### Quais qualificações o Email Verifier retorna? O [Email Verifier](/pt/api-reference/email-verifier/verify-single) retorna um dos seguintes valores no campo `qualification`: | Qualification | Meaning | | ------------- | ----------------------------------- | | `valid` | E-mail é válido e entregável | | `invalid` | E-mail é inválido ou não entregável | | `ongoing` | Verificação ainda em andamento | `invalid` significa coisas diferentes dependendo do endpoint: no **Email Finder**, significa que o e-mail não foi encontrado. No **Email Verifier**, significa que o e-mail existe, mas não é entregável. ### Quais qualificações o Phone Finder retorna? O [Phone Finder](/pt/api-reference/phone/find-single) retorna um dos seguintes valores no campo `qualification`: | Qualification | Meaning | | ------------- | ------------------------------------------ | | `found` | Número de telefone localizado com sucesso | | `not_found` | Número de telefone não pôde ser encontrado | | `ongoing` | Busca ainda em andamento | ### Como acompanho uma busca em massa? Para operações em massa, um campo `status` indica o progresso do lote. Faça polling no endpoint GET relevante — [resultados em massa do Email Finder](/pt/api-reference/email-finder/get-bulk-results), [verificações em massa do Email Verifier](/pt/api-reference/email-verifier/get-bulk-verifications) ou [resultados em massa do Phone Finder](/pt/api-reference/phone/get-bulk-results) — até que o `status` seja `completed`. | Status | Meaning | | ----------- | ---------------------------------------- | | `ongoing` | O lote ainda está sendo processado | | `completed` | Todas as buscas do lote foram concluídas | | `failed` | O lote falhou | ## FAQ Um `401 Unauthorized` significa que a chave de API está ausente ou inválida. Certifique-se de que cada requisição inclua uma chave válida no cabeçalho `x-api-key`. Consulte [Autenticação](/pt/authentication) para mais detalhes. Um `402 Payment Required` significa que a conta não tem créditos suficientes para concluir a requisição. Recarregue ou revise como os créditos são consumidos por endpoint em [Créditos e cobrança](/pt/credits-billing). A API Enrow nunca retorna `404`. Um ID de busca desconhecido ou expirado retorna `400` para endpoints em massa e `500` para endpoints individuais. Verifique novamente o `id` retornado quando a busca foi iniciada. Não. `ongoing` significa que a busca ou verificação ainda está em andamento. Faça polling no endpoint GET novamente após um breve intervalo, ou use um webhook para ser notificado automaticamente quando ela terminar — consulte [Como os webhooks funcionam](/pt/how-webhooks-work). ## Próximos passos Veja as mensagens de erro completas e os formatos de resposta para cada código de status. Envie sua chave de API no cabeçalho x-api-key para evitar erros 401. Entenda os limites que disparam uma resposta 429. Veja como os créditos são consumidos e evite erros 402.