> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/001_user/013_notifications/002__get_recent_notifications.md).

# Get Recent Notifications

GraphQL endpoint: `/user`

Returns the top N notifications ordered unread-first, then most recent within each group, so unread items stay visible even when read items are newer. The limit defaults to 5 when omitted.

## Query

```graphql
query ($limit: Int) {
  recentNotifications(limit: $limit) {
    id
    status
  }
}

```

## Variables

```json
{
  "limit": 5
}
```

## Response

```json
{
  "data": {
    "recentNotifications": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "status": "UNREAD"
      },
      {
        "id": "00000000-0000-4000-8000-000000000002",
        "status": "UNREAD"
      },
      {
        "id": "00000000-0000-4000-8000-000000000003",
        "status": "READ"
      }
    ]
  }
}
```