---
title: "Get User Notifications"
method: GET
path: "/api/v3/notifications/users/{user_id}/events"
tags: ["Notifications"]
---

# Get User Notifications

`GET /api/v3/notifications/users/{user_id}/events`

Get notifications for a user's notification tray.

## Path parameters

- `user_id` integer, required

## Query parameters

- `unread_only` boolean
- `limit` integer
- `offset` integer

## Response `200`

Request fulfilled, document follows

- NotificationEventResponse[]
  - `id` integer, required
  - `user_id` integer, required
  - `event_type` 'verification_approved' | 'verification_rejected' | 'record_removed' | 'record_edited' | 'auto_verify_failed' | 'skill_role_update' | 'xp_gain' | 'rank_up' | 'prestige' | 'mastery_earned' | 'lootbox_earned' | 'playtest_update' | 'map_edit_approved' | 'map_edit_rejected' | 'quest_complete' | 'quest_rotation' | 'quest_rival_mention', required
  - `title` string, required
  - `body` string, required
  - `metadata` object, nullable
  - `created_at` string, required
  - `read_at` string, nullable
  - `dismissed_at` string, nullable

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api-2.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api-2/revisions/d14c3e9eddba/schema)