---
title: "Changes to Get a list of user alerts"
method: GET
path: "/alerts/"
---

# Changes to Get a list of user alerts

`GET /alerts/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 7 revisions.

- **2026-03-18** `e271d0e41f6d` — 2 breaking, 24 info
- **2026-02-03** `fc0a40f3b859` — 2 breaking, 23 warning, 3 info

## Changes

- **2026-03-18** `e271d0e41f6d` — 2 breaking, 24 info
  - the `alerts/items/` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - the `pagination` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - api operation id `get_alerts_` removed and replaced with `getAlerts`
  - the endpoint scheme security `XF-Api-Key` was added to the API
  - the endpoint scheme security `XF-OAuth2` was added to the API
  - added the new optional `header` request parameter `XF-Api-User` to all path's operations
  - added the new optional `query` request parameter `api_bypass_permissions` to all path's operations
  - added the optional property `alerts/items/User` to the response with the `200` status
  - added the optional property `alerts/items/action` to the response with the `200` status
  - added the optional property `alerts/items/alert_id` to the response with the `200` status
  - added the optional property `alerts/items/alert_text` to the response with the `200` status
  - added the optional property `alerts/items/alert_url` to the response with the `200` status
  - added the optional property `alerts/items/alerted_user_id` to the response with the `200` status
  - added the optional property `alerts/items/auto_read` to the response with the `200` status
  - added the optional property `alerts/items/content_id` to the response with the `200` status
  - added the optional property `alerts/items/content_type` to the response with the `200` status
  - added the optional property `alerts/items/event_date` to the response with the `200` status
  - added the optional property `alerts/items/read_date` to the response with the `200` status
  - added the optional property `alerts/items/user_id` to the response with the `200` status
  - added the optional property `alerts/items/username` to the response with the `200` status
  - added the optional property `alerts/items/view_date` to the response with the `200` status
  - added the optional property `pagination/current_page` to the response with the `200` status
  - added the optional property `pagination/last_page` to the response with the `200` status
  - added the optional property `pagination/per_page` to the response with the `200` status
  - added the optional property `pagination/shown` to the response with the `200` status
  - added the optional property `pagination/total` to the response with the `200` status
- **2026-02-03** `fc0a40f3b859` — 2 breaking, 23 warning, 3 info
  - the `alerts/items/` response's property type/format changed from `object`/`` to `string`/`` for status `200`
  - the `pagination` response's property type/format changed from `object`/`` to `string`/`` for status `200`
  - the optional response header `XF-Latest-Api-Version` removed for the status `200`
  - the optional response header `XF-Request-User` removed for the status `200`
  - the optional response header `XF-Request-User-Extras` removed for the status `200`
  - the optional response header `XF-Used-Api-Version` removed for the status `200`
  - removed the optional property `alerts/items/User` from the response with the `200` status
  - removed the optional property `alerts/items/action` from the response with the `200` status
  - removed the optional property `alerts/items/alert_id` from the response with the `200` status
  - removed the optional property `alerts/items/alert_text` from the response with the `200` status
  - removed the optional property `alerts/items/alert_url` from the response with the `200` status
  - removed the optional property `alerts/items/alerted_user_id` from the response with the `200` status
  - removed the optional property `alerts/items/auto_read` from the response with the `200` status
  - removed the optional property `alerts/items/content_id` from the response with the `200` status
  - removed the optional property `alerts/items/content_type` from the response with the `200` status
  - removed the optional property `alerts/items/event_date` from the response with the `200` status
  - removed the optional property `alerts/items/read_date` from the response with the `200` status
  - removed the optional property `alerts/items/user_id` from the response with the `200` status
  - removed the optional property `alerts/items/username` from the response with the `200` status
  - removed the optional property `alerts/items/view_date` from the response with the `200` status
  - removed the optional property `pagination/current_page` from the response with the `200` status
  - removed the optional property `pagination/last_page` from the response with the `200` status
  - removed the optional property `pagination/per_page` from the response with the `200` status
  - removed the optional property `pagination/shown` from the response with the `200` status
  - removed the optional property `pagination/total` from the response with the `200` status
  - api operation id `getAlerts` removed and replaced with `get_alerts_`
  - the endpoint scheme security `XF-Api-Key` was removed from the API
  - the endpoint scheme security `XF-OAuth2` was removed from the API

---

[Operation](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/alerts/get.md) · [API](https://skmtc.dev/xenforo-ltd/apis/xenforo-api.md) · [Page](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/changes/alerts/get)