# List notifications

Retrieve a paginated list of notifications for the authenticated user, with optional filters by status, channel, and date range.

Endpoint: GET /notifications/notifications
Version: 1.0
Security: bearerAuth

## Header parameters:

  - `x-fingerprint-id` (string, required)
    Unique device or session fingerprint identifier used for security and fraud prevention.

## Query parameters:

  - `page` (string, required)
    Page number to access

  - `limit` (string, required)
    Number of items to be loaded per page

  - `status` (string)
    Filter notifications by status.
    Enum: "queued", "sending", "sent", "delivered", "failed", "retrying", "dropped", "canceled", "read"

  - `channel` (string)
    Filter notifications by delivery channel.
    Enum: "email", "sms", "web-push", "mobile-push", "whatsapp", "*"

  - `startDate` (string)
    Filter notifications created from this date (inclusive).
    Example: "2026-01-01T00:00:00.000Z"

  - `endDate` (string)
    Filter notifications created until this date (inclusive).
    Example: "2026-01-31T23:59:59.999Z"

## Response 200 fields (application/json):

  - `statusCode` (integer)
    Example: 200

  - `data` (object)

  - `data.docs` (array)

  - `data.docs.id` (string)
    Example: "65dcd6b92f8a4e0029c4e881"

  - `data.docs.createdAt` (string)
    Example: "2026-01-24T19:42:10.110Z"

  - `data.docs.updatedAt` (string)
    Example: "2026-01-29T19:01:33.450Z"

  - `data.docs.deleted` (string)

  - `data.docs.userId` (string)
    Example: "b1f93c2d-9e3a-4f2b-9c11-7e3a4b2f8d91"

  - `data.docs.status` (string)
    Enum: "queued", "sending", "sent", "delivered", "failed", "retrying", "dropped", "canceled", "read"

  - `data.docs.deviceId` (string)
    Example: "device-88c1e2"

  - `data.docs.templateId` (string)
    Example: "65dccf1b912671528d444bbb"