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

# GET /notifications

`GET /notifications`

## Request

- Base URL: `https://api.laver.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.laver.app/notifications`
- Auth: HTTP bearer

## Query parameters

- `no_token_refresh` '1'
- `cursor` string
- `unread_only` '1'
- `count_only` '1'

## Response `200`

Success. The properties described here are the ones the response schema enforces; the body also carries fields it does not yet declare.

- object
  - `notifications` object[], nullable
    - `actor` object, nullable
      - `uuid` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `profile_image_url` string, nullable

## Other responses

- `400`: The request failed schema validation, or the handler rejected its contents. Undeclared properties are rejected on every body, path and query schema, so an unexpected field is a 400 rather than a silently ignored one.
- `401`: No credential, or one that is expired, revoked or not accepted by this endpoint.
- `429`: The rate limit was exceeded. The budget is keyed on the authenticated session user or API key, falling back to the caller IP.

---

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