---
title: "Lists the authenticated account's notifications, newest first."
method: GET
path: "/api/notifications"
tags: ["notifications"]
---

# Lists the authenticated account's notifications, newest first.

`GET /api/notifications`

## Request

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

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of the account's notifications.

- ListNotificationsResponse: `GET /api/notifications` response.
  - `has_more` boolean, required: Whether older events follow this page.
  - `last_seen_at` string, date-time, nullable: The caller's stored cursor, or `null` when it has never been advanced.
  - `next_cursor` string, nullable: The token to pass back as `cursor` to read the next page, present only when `has_more` is true.
  - `notifications` NotificationResponse[], required: The page, newest first.
    - `event_type` string, required: The event's slug, which doubles as the page's filter value.
    - `family` string, required: The group the event is filed under, for the family filter.
    - `id` string, uuid, required: The event's UUID, so a client can key a rendered line.
    - `occurred_at` string, date-time, required: When the event was recorded.
    - `params` object, required: The values the event's text interpolates: a flat object of strings and whole numbers, empty when the text has none.
    - `severity` string, required: How loudly the event presents itself, driving its accent.
    - `translation_key` string, required: The dashboard locale key carrying this event's text.
  - `unseen_count` integer, required: How many events are newer than the caller's cursor.

## Other responses

- `400`: Malformed cursor.
- `401`: Missing or invalid JWT.

---

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