***

title: Response Codes
slug: response-codes
---------------------

For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://api.alsona.com/llms.txt. For full documentation content, see https://api.alsona.com/llms-full.txt.

All API responses return a standard HTTP status code. On error, the response body includes a `success: false` flag and a `message` field with details.

```json
{
	"success": false,
	"message": "Permission denied: GET /accounts/{account_id}/campaigns"
}
```

## Status Codes

| Code | Status                | Description                                                                  |
| ---- | --------------------- | ---------------------------------------------------------------------------- |
| 200  | Success               | Request was successful.                                                      |
| 400  | Bad Request           | The request path or parameters are invalid.                                  |
| 401  | Unauthorized          | Missing or invalid API key, or the key does not have access to this account. |
| 403  | Forbidden             | The API key does not have permission for the requested endpoint or method.   |
| 404  | Not Found             | The requested resource or route does not exist.                              |
| 500  | Internal Server Error | An unexpected error occurred on the server.                                  |