This resource returns list of alerts from given timestamp for given list of registration numbers.
Alerts are grouped by registration numbers.

It also allows to filter results by message type. List of all possible types is available to
fetch using /alerts/types resource).

Resource URL

https://api.safeguard24.eu/{version}/alerts/{timestamp}/{numbers}

Parameters

Parameter Description Required Default
page Page number (e.g. page=1) no 1
filter Filter alerts by message type (e.g. filter=8,14,18). no none

Example

GET
https://api.safeguard24.eu/v1.0/alerts/1009839601/XZY1234,FOO9999,BAR1111?page=1&filter=8,14,18

Response body

  {
    "error": false,
    "msg": "Alerts list",
    "status": 200
    "_data": {
      "alerts": {
        "XZY1234": [
          {
            "history": "1",
            "id": "113899",
            "message": "Zamek został zaryglowany",
            "message_type": "14",
            "reading_id": "32363510",
            "latitude": 513558,
            "longitude": 193238,
            "speed": 63,
            "registration_number": "XZY1234",
            "timestamp": "2024-01-01 00:01:00"
          },
          {
            "history": "1",
            "id": "113900",
            "message": "PANIC BUTTON",
            "message_type": "8",
            "reading_id": "76101397",
            "latitude": 513558,
            "longitude": 193238,
            "speed": 63,
            "registration_number": "XZY1234",
            "timestamp": "2024-01-01 00:02:00"
          }
        ],
        "FOO9999": [
          {
            "history": "1",
            "id": "113841",
            "message": "Zamek został zaryglowany",
            "message_type": "14",
            "reading_id": "76081649",
            "latitude": 513558,
            "longitude": 193238,
            "speed": 63,
            "registration_number": "FOO9999",
            "timestamp": "2024-01-01 00:03:00"
          },
          {
            "history": "1",
            "id": "113897",
            "message": "Odpięcie naczepy",
            "message_type": "18",
            "reading_id": "76101420",
            "latitude": 513558,
            "longitude": 193238,
            "speed": 63,
            "registration_number": "FOO9999",
            "timestamp": "2024-01-01 00:04:00"
          }
        ],
        "BAR1111": [
          {
            "history": "1",
            "id": "113901",
            "message": "PANIC BUTTON",
            "message_type": "8",
            "reading_id": "76101397",
            "registration_number": "BAR1111",
            "timestamp": "2024-01-01 00:05:00"
          }
        ]
      },
      "alerts_count": 12,
      "from": 1009839601,
      "limit": 5,
      "page_current": 1,
      "page_next": 2
    }
  }

Error Response

  {
    "error": true,
    "msg": "No alerts found for given trailers from given timestamp.",
    "status": 406
  }

Resource Information

API version v1.0
Method GET
Authentication HMAC
Response Format JSON