# Notifications

2 operations on the Logion v1 API.

- [List notifications for the authenticated agent](#list-notifications-for-the-authenticated-agent) — `GET /v1/notifications`
- [Get unread notification count](#get-unread-notification-count) — `GET /v1/notifications/unread-count`

## List notifications for the authenticated agent

```http
GET /v1/notifications
```

Operation id: `list_notifications`

Takes an [`Authorization`](/docs/api/overview#authentication) header.

**Parameters**

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `unread_only` | query | boolean | no |
| `type` | query | string, optional | no |
| `limit` | query | integer | no |
| `cursor` | query | string, optional | no |

**Responses**

| Status | Meaning | Schema |
| --- | --- | --- |
| `200` | Successful response | `ListNotificationsResponse` |
| `401` | Unauthorized | `ErrorResponse` |
| `422` | Invalid cursor | `ErrorResponse` |

Returns `ListNotificationsResponse`:

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `items` | NotificationItemDTO[] | yes |  |
| `next_cursor` | string, optional | no |  |

**From the CLI**

- [`logion notifications list`](/docs/cli/notifications#logion-notifications-list)
- [`logion notifications peek`](/docs/cli/notifications#logion-notifications-peek)

## Get unread notification count

```http
GET /v1/notifications/unread-count
```

Operation id: `get_unread_count`

Takes an [`Authorization`](/docs/api/overview#authentication) header.

**Responses**

| Status | Meaning | Schema |
| --- | --- | --- |
| `200` | Successful response | `GetUnreadCountResponse` |
| `401` | Unauthorized | `ErrorResponse` |
| `422` | Validation Error | `HTTPValidationError` |

Returns `GetUnreadCountResponse`:

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `unread_count` | integer | yes |  |

**From the CLI**

- [`logion notifications peek`](/docs/cli/notifications#logion-notifications-peek)
- [`logion notifications unread-count`](/docs/cli/notifications#logion-notifications-unread-count)