> ## Documentation Index > Fetch the complete documentation index at: https://docs.ar-online.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Mensagens de erro > Códigos HTTP retornados pela API, mensagens em PT-BR, causas prováveis e como resolver. A API retorna erros no formato JSON, com um campo `statusCode` (código HTTP) e uma `message` descritiva. Esta página agrupa as mensagens conhecidas por código HTTP, com a causa provável e como resolver cada uma. ```json theme={null} { "statusCode": 404, "message": "Registro não encontrado" } ``` Indica que algum dado enviado na requisição é inválido ou que uma pré-condição da conta não foi atendida. | Mensagem | Causa provável | Como resolver | | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | `O e-mail do destinatário informado é inválido, Verifique o endereço de e-mail inserido.` | O campo `to` contém um endereço de e-mail malformado. | Verifique o endereço de e-mail do destinatário antes de enviar. | | `O número do destinatário informado é inválido, Verifique o número inserido.` | O número de telefone informado (`sms.number`, `whatsapp.number` ou `voz.number`) está em formato inválido. | Envie o número sem máscaras, no formato esperado (DDD + número). | | `Você está tentando enviar um email, você não possui créditos suficientes` | A conta não tem créditos para o envio. | Verifique o saldo da conta e contrate/recarregue créditos com o time comercial. | | `Erro ao obter informações do plano.` | Não foi possível recuperar as informações do plano da conta. | Tente novamente; se persistir, contate o suporte ([suporte@ar-online.com.br](mailto:suporte@ar-online.com.br)). | | `Validation failed (uuid is expected)` | O `idEmail`/`id` informado no path não é um UUID válido. | Use o UUID retornado no envio (`idEmail`) ou o `id` correto do template. | | `Tipo de template inválido. Valores aceitos: 1 (WhatsApp), 2 (Email), 3 (SMS), 4 (Carta)` | O parâmetro `type` enviado na listagem de templates não é um valor aceito. | Use um dos valores válidos: `1`, `2`, `3` ou `4`. | Recursos sujeitos a habilitação prévia também podem retornar 400 quando a conta não está habilitada — por exemplo, o uso de `validation` exige conta habilitada. Indica falha de autenticação/autorização: token ausente ou inválido, destinatário bloqueado, ou canal que exige habilitação prévia. | Mensagem | Causa provável | Como resolver | | ------------------------------------------------------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | `Unauthorized` | Token ausente, inválido ou expirado no header `Authorization`. | Envie o token JWT válido no header `Authorization`, **sem** o prefixo `Bearer`. Veja [Autenticação](/autenticacao). | | `Você tentou enviar um email para ${emailTo}, porém ele está em uma blacklist` | O destinatário está em uma lista de bloqueio (blacklist). | Confirme o destinatário; se necessário, contate o suporte para tratar a blacklist. | Indica que o token é válido, mas a operação não é permitida para o usuário. | Mensagem | Causa provável | Como resolver | | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | | `Você não tem permissão para editar este template` | Apenas o dono do template pode editá-lo, ativá-lo/desativá-lo ou excluí-lo — mesmo quando o template está compartilhado. | Use uma conta que seja dona do template ou solicite a alteração ao proprietário. | Indica que o recurso consultado não existe ou que o status ainda não está disponível. | Mensagem | Causa provável | Como resolver | | ---------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------- | | `Registro não encontrado` | O `idEmail` consultado não existe (ex.: laudo pericial). | Confirme o `idEmail` retornado no envio. | | `Email sem status!` | O e-mail ainda não possui status registrado. | Aguarde o processamento e consulte novamente; o envio é assíncrono. | | `O comprovante para e- mail consultado ainda não possui o status de entrega` | O comprovante só fica disponível após o status de entrega. | Aguarde a entrega e consulte o comprovante novamente. | | `Carta não encontrado` | Não há registro de carta para o `idEmail` informado. | Confirme o `idEmail` e se o envio incluiu o canal Carta. | | `Template não encontrado` | O `id` do template não existe ou não é acessível pelo usuário. | Confirme o UUID do template e o acesso da conta. | Indica que o limite de taxa foi excedido. | Mensagem | Causa provável | Como resolver | | ------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `Too Many Requests` | O número de requisições ultrapassou o rate limit do endpoint. | Reduza a frequência de chamadas, implemente retry com backoff exponencial e cadastre seu IP na whitelist. Veja [Rate limit](/referencia/rate-limit). | Indica uma falha inesperada no processamento da requisição. | Mensagem | Causa provável | Como resolver | | ---------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Não foi possível enviar o email.` | Falha ao processar o envio do e-mail. | Tente novamente; se persistir, contate o suporte ([suporte@ar-online.com.br](mailto:suporte@ar-online.com.br)) informando o `customID` ou o horário da tentativa. | | `Internal Server Error` | Erro interno genérico no servidor. | Tente novamente após alguns instantes; se persistir, contate o suporte ([suporte@ar-online.com.br](mailto:suporte@ar-online.com.br)). |