Skip to content
Mobile Joe Docs Dashboard
View Markdown

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

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

Parameters

Name / locationRequired / typeDetails
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.

Responses

200 — Successful response

application/json · array of Alert schema

[
  {
    "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.