---
title: "Get Notifications"
method: GET
path: "/api/notifications"
tags: ["notifications"]
---

# Get Notifications

`GET /api/notifications`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/notifications`
- Auth: none declared

## Query parameters

- `page` integer
- `page_size` integer
- `unread_only` boolean
- `channel` 'email' | 'sms' | 'deal', nullable

## Response `200`

OK

- NotificationListSchema
  - `items` NotificationSchema[], required
    - `id` integer, required
    - `channel` 'email' | 'sms' | 'deal', required
    - `title` string, required
    - `preview` string, required
    - `target_url` string, required
    - `source_message_id` string, required
    - `source_thread_id` string, required
    - `related_deal_id` integer, nullable
    - `read_at` string, date-time, nullable
    - `resolved_at` string, date-time, nullable
    - `actionable` boolean
    - `created_at` string, date-time, required
  - `total` integer, required
  - `unread_count` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `cards_enabled` boolean, required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-09-17** `1979433dd6f0`: 2 info
  - added the optional property `items/items/actionable` to the response with the `200` status
  - added the optional property `items/items/resolved_at` to the response with the `200` status
- **2026-09-03** `a4d14d6fdc7d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/notifications/get.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)