> For the complete documentation index, see [llms.txt](https://ajuda.livechat360.com.br/crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.livechat360.com.br/crm/api-docs/erros.md).

# Erros

Todos os erros usam o mesmo envelope:

```json
{ "errors": [ { "field": "...", "detail": "..." } ] }
```

## 400 · Requisição inválida

Parâmetros de query inválidos, JSON malformado ou corpo acima de 512 KB. Vários parâmetros inválidos são relatados juntos:

```json
{
  "errors": [
    { "field": "status", "detail": "Valor inválido. Valores permitidos: ongoing, won, lost" },
    { "field": "created_at__gte", "detail": "Data inválida. Use o formato ISO 8601" },
    { "field": "per_page", "detail": "Informe um número inteiro maior que zero" }
  ]
}
```

## 401 · Não autenticado

Sempre o mesmo corpo, qualquer que seja o problema com a credencial:

```json
{ "errors": [{ "detail": "Chave de API inválida" }] }
```

Veja [Autenticação](file:///7732829/comecando/autenticacao.md).

## 403 · Sem permissão

```json
{ "errors": [{ "detail": "A chave de API não possui permissão para esta operação" }] }
```

Veja [Escopos e permissões](file:///7732829/comecando/escopos-e-permissoes.md).

## 404 · Não encontrado

Rota desconhecida ou recurso inexistente. Ids de outra conta também retornam 404, indistinguíveis de ids inexistentes.

```json
{ "errors": [{ "detail": "Negociação não encontrada" }] }
```

## 422 · Validação do corpo

Todos os problemas do corpo em uma única resposta:

```json
{
  "errors": [
    { "field": "phone", "detail": "Telefone inválido. Informe de 10 a 15 dígitos, incluindo DDI e DDD" },
    { "field": "custom_fields.erp", "detail": "Campo personalizado não encontrado" }
  ]
}
```

## 429 · Limite excedido

Veja [Limites de requisição](broken://pages/a6c4eecbe4dc3ce3e49937676eb84aa93b666068).

## 500 · Erro interno

```json
{ "errors": [{ "detail": "Erro interno do servidor" }] }
```

Nenhum detalhe interno é exposto. Se o erro persistir, entre em contato com o suporte informando o horário e a rota chamada.