REST API

# List alerts

`GET https://mbj-api.com/v1/alerts`

Returns an unpaginated array; no ordering is guaranteed. Normally returns live alerts for all users or matching the device audience. Filtered audiences require a recognized OS and configured filters for that platform. Each configured app/OS version list must contain the corresponding header exactly; missing versions fail configured lists. Alerts without an audience are not normally delivered. Debug-Mode: true (case-insensitive) additionally includes every non-archived debug-marked alert, including drafts, bypassing audience filters. Archived alerts are always excluded. Localized by Preferred-Languages or Language-Code with original-content fallback. No identity headers required.

## Request

```sh
curl --include --request GET 'https://mbj-api.com/v1/alerts' \
  --header 'Authorization: Token token=YOUR_API_KEY'
```

## Parameters

| Name / location | Required / type | Details |
| --- | --- | --- |
| `Debug-Mode` / header | No / string | Enable debug mode to include draft alerts marked for debugging Values: `true, false` Example: `"false"` |

Headers: `OS-Name`, `App-Version`, `OS-Version`, `Preferred-Languages`, `Language-Code`. See [Headers](https://docs.mobilejoe.dev/api.md#headers).

## Responses

### 200 — Successful response

`application/json` · [array of Alert schema](https://docs.mobilejoe.dev/api/schemas.md)

```json
[
  {
    "id": 1,
    "title": "Service Outage",
    "message": "Some users may experience login issues",
    "status": "live",
    "kind": "error",
    "occurred_at": "2024-01-08T00:00:00Z",
    "created_at": "2024-01-08T12:00:00Z",
    "updated_at": "2024-01-08T12:00:00Z"
  }
]
```

Errors: 401, 403, and 429. See [Errors](https://docs.mobilejoe.dev/api.md#errors).