alerts

Get all notifications from latest 7 days

Changed on Nov 3, 2026

get all notifications from latest 7 days

get/users/by-username/{username}/notifications/recent

Request

Base URL
https://api.securityscorecard.io
URL
https://api.securityscorecard.io/users/by-username/{username}/notifications/recent
Auth
API key in header Authorization

Path parameters

usernamestring required

username the notifications' owner

Query parameters

portfoliostring

filter notifications by portfolio id

sortstring

sort notifications by unread status or date

orderstring

specify the order of sorting, asc or desc

unreadboolean

Whether to filter by read or unread notifications

page_sizenumber

page size

Response

A page in a list of Notifications

categorystring

notification category: standard, prioritized, queued, or customer_contacts

pageinteger required

page

sizeinteger required

size

Example response

{
  "entries": [
    {
      "created_at": "2020-01-01T00:00:00.000Z",
      "read": "2020-01-01T00:00:00.000Z",
      "processed_on": "2020-01-01T00:00:00.000Z"
    }
  ]
}

Changes

Nov 3, 2026b465b4846039 Revision changes
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  removed the required property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  media type application/json; charset=utf-8 was changed to application/json for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property to the response with the status
- info
  the // response's property pattern was changed from ^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}:\d{2}\.{0,1}\d*Z$ to ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}\.{0,1}[0-9]*Z$ for the status
- info
  the // response's property pattern was changed from ^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}:\d{2}\.{0,1}\d*Z$ to ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}\.{0,1}[0-9]*Z$ for the status
- info
  the // response's property pattern was changed from ^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}:\d{2}\.{0,1}\d*Z$ to ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}\.{0,1}[0-9]*Z$ for the status

Operation history