> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить уведомление

> Возвращает одно доступное уведомление по его идентификатору.

Возвращает одно доступное уведомление по его идентификатору.

## Доступ

Передавайте `XF-Api-Key` в заголовке каждого запроса. [Типы ключей и выбор пользователя](/guard-forum/authentication).

Требуемые scopes: `alert:read`. Все перечисленные разрешения нужны одновременно.

Нужен контекст зарегистрированного пользователя. Для Super key укажите `XF-Api-User`; доступ к объектам и действиям проверяется отдельно от scopes.

## Параметры

**XF-Api-Key** `string` *required*

Секретный API-ключ. В примерах ключ берётся из серверной переменной `$FORUM_API_KEY`.

**id** `integer` *required*

Идентификатор уведомления.

Других входных параметров у метода нет. Общие параметры контекста описаны в [разделе авторизации](/guard-forum/authentication).

## Ответ

HTTP `200`, JSON. [Схемы объектов и условные поля](/guard-forum/models).

**alert** `UserAlert`

Описание уведомления и его состояния.

Ошибки возвращаются в общей структуре `errors`. Обрабатывайте поле `code`; текст `message` может меняться или переводиться. [Формат ошибок](/guard-forum/requests-and-errors).

```bash cURL theme={null}
curl --request GET 'https://forum.arzguard.com/api/alerts/123/' \
  --header "XF-Api-Key: $FORUM_API_KEY"
```

```json 200 · условный пример theme={null}
{
  "alert": {
    "alert_id": 123,
    "read_date": 0,
    "view_date": 0
  }
}
```

Примеры сокращены и содержат только условные значения. Состав полей объектов зависит от прав, контекста и установленных дополнений.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.