Skip to content

List Notifications

Retrieve in-app notifications. Notifications are user-scoped: the feed an API key sees is the personal feed of the user who created the key.

GET /v1/notifications
GET /v1/notifications/unread-count

List

GET /v1/notifications

Query Parameters

ParameterTypeDescription
pagenumberPage number (default: 1)
per_pagenumberItems per page (default: 20, max: 100)

Response

json
{
  "data": [
    {
      "id": "ntf_xxx",
      "type": "license",
      "title": "New license issued",
      "message": "A license was issued to [email protected]",
      "link": "/licenses/lic_xxx",
      "isRead": false,
      "createdAt": "2026-06-12T09:58:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 14,
    "totalPages": 1
  }
}

Unread count

GET /v1/notifications/unread-count
json
{
  "data": {
    "count": 3
  }
}

Example

bash
curl -X GET "https://api.packedge.dev/v1/notifications/unread-count" \
  -H "Authorization: Bearer pk_your_api_key"