> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Error response format and the codes returned by the GOWA API.

Errors use the standard envelope with a non-`SUCCESS` code:

```json theme={null}
{
  "code": "VALIDATION_ERROR",
  "message": "phone: cannot be blank."
}
```

Branch on the HTTP status and `code`, not on `message`.

| HTTP | Codes |
| - | - |
| 400 | `VALIDATION_ERROR`, `INVALID_JID`, `ALREADY_LOGGED_IN`, `DEVICE_ID_REQUIRED` |
| 401 | `AUTHENTICATION_ERROR` (device not logged in); also Basic Auth failures (no JSON `code`) |
| 403 | `AVATAR_HIDDEN`, `CROSS_SITE_REQUEST_BLOCKED` |
| 404 | `NOT_FOUND`, `DEVICE_NOT_FOUND`, `AVATAR_NOT_SET` |
| 408 | `CONTEXT_ERROR` |
| 429 | `WA_REACHOUT_TIMELOCK` |
| 500 | `INTERNAL_SERVER_ERROR`, `QR_CHANNEL_ERROR`, `SESSION_SAVED_ERROR`, `UPLOAD_MEDIA_ERROR`, `WEBHOOK_ERROR`, `INVALID_WA_CLI` |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` |
| 504 | `GATEWAY_TIMEOUT` |

Meanings, fixes and retry guidance: [Error handling](https://gowa-docs.mintlify.site/advanced/error-handling.md).

For `GET /user/avatar`, `AVATAR_NOT_SET` means the contact has no profile picture. `AVATAR_HIDDEN` means privacy settings deny access. Preserve a cached picture on a privacy denial, and distinguish these codes from device-selection errors.


## Related topics

- [Error Handling](https://gowa-docs.mintlify.site/advanced/error-handling.md)
- [Multi-Device & Device Selection](https://gowa-docs.mintlify.site/concepts/multidevice.md)
- [Chatwoot Integration](https://gowa-docs.mintlify.site/integrations/chatwoot.md)
- [API Reference](https://gowa-docs.mintlify.site/api-reference/introduction.md)
- [List live updates subscriptions of the device](https://gowa-docs.mintlify.site/api-reference/newsletter/list-live-updates-subscriptions-of-the-device.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.