> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ListNotifications

> List the current user's notifications.

# ListNotifications

List the current user's notifications. By default returns active notifications (not deleted, not done), ordered by most recent first. Use `states` to select exact unseen, seen, or done states. Seen excludes done; an empty list includes all states.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `limit` | integer | No | Maximum number of notifications to return. Defaults to 20, max 50. |
| `states` | (`"unseen"` \| `"seen"` \| `"done"`)\[] | No | Exact states to include: unseen, seen, done. Defaults to \[unseen, seen]. An empty list includes all states. |
| `includeTypes` | (`"email"` \| `"message"` \| `"channel"` \| `"document"` \| `"project"` \| `"call"` \| `"task"` \| `"github"` \| `"reminder"` \| `"calendar"` \| `"agent"`)\[] | No | Filter to specific notification item types. If omitted, returns all types. Example: \["email", "message"] returns only email and message notifications. |
| `entities` | NotificationEntityFilter\[] | No | Filter to notifications for specific entities. Pair each id with its canonical entityType to avoid ambiguity. Example: \[\{"entityType":"email\_thread","id":"..."}] returns notifications for one email thread. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.