---
title: "List Notifications"
method: GET
path: "/notifications"
tags: ["notifications"]
---

# List Notifications

`GET /notifications`

## Request

- Base URL: `https://api.claimkit.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.claimkit.co/notifications`
- Auth: none declared

One page of the session user's notifications, newest first, plus the total unread count.

Pass the last item's id as ``before_id`` to fetch the next (older) page;
``has_more`` says whether there is one. ``unread_count`` covers every
page, so an unread item past the first page is still counted and can be
reached by paging.

## Query parameters

- `limit` integer
- `before_id` integer, nullable

## Response `200`

Successful Response

- NotificationListResponse
  - `notifications` NotificationItem[], required
    - `id` integer, required
    - `kind` string, required
    - `title` string, required
    - `body` string, nullable, required
    - `claim_id` integer, nullable, required
    - `answer_id` integer, nullable, required
    - `comment_id` integer, nullable, required
    - `read_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `link` string, nullable, required
  - `unread_count` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimkit/apis/claimkit-api.md) - [All operations](https://skmtc.dev/claimkit/apis/claimkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/claimkit/apis/claimkit-api/revisions/94dc85ba5326?raw)