---
title: "List CRM notifications"
method: GET
path: "/api/notification-campaigns"
tags: ["crm-notifications"]
---

# List CRM notifications

`GET /api/notification-campaigns`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/notification-campaigns`
- Auth: HTTP bearer

Scheduled and sent CRM notifications, including the immediate sends from the patient list, latest send date first.

## Query parameters

- `limit` integer: Max notifications to return.
- `offset` integer: Pagination offset.

## Response `200`

Successful Response

- CRMNotificationCampaignListItem[]
  - `id` string, required: Campaign UUID.
  - `status` string, required: scheduled | sending | sent | failed | cancelled.
  - `scheduled_at` string, date-time, nullable: When it is, or was, scheduled to go out.
  - `title` string, required: Notification title.
  - `body` string, required: Notification text.
  - `notes` string, nullable: Internal note; CRM-only.
  - `audience_type` string, required: 'filters', 'csv' or 'users'.
  - `audience_size` integer, nullable: Addresses (csv) or patients (users) in an explicit audience; null for filters.
  - `resolved_count` integer, nullable: Patients in the audience when it was sent.
  - `reached_count` integer, nullable: Patients reached on at least one device.
  - `unreached_count` integer, nullable: Patients not reached.
  - `sent_at` string, date-time, nullable: When the send finished.
  - `error` string, nullable: Failure reason, if the send failed.
  - `created_by_name` string, nullable: Who created it, when known.
  - `created_at` string, date-time, required: When it was created.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `f32c7ff0d5a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/notification-campaigns/get.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/4a8dd89893b8?raw)
