---
title: "List notifications for the current user"
method: GET
path: "/v1/notifications"
tags: ["Notifications"]
---

# List notifications for the current user

`GET /v1/notifications`

## Request

- Base URL: `https://api.signvoy.com`
- URL: `https://api.signvoy.com/v1/notifications`
- Auth: one of:
  - API key in header `X-Workspace-Id`
  - HTTP bearer

## Query parameters

- `unread` boolean
- `limit` number

## Response `200`

- NotificationDto[]
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `userId` string, required
  - `type` 'recipient_signed' | 'document_completed' | 'document_declined' | 'document_expired', required
  - `title` string, required
  - `body` string, required
  - `documentId` string, uuid, nullable, required
  - `data` object, nullable, required
  - `readAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required

---

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