Skip to content
Adversarial

list notifications for user

GET
/v1/notifications

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
page
integer format: int64
page_size
integer format: int64
include_read
boolean

Whether to include read notifications. Defaults to true.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successfully retrieved list of notifications

object
notifications
required
Array<object>
object
contributor
required

A User as returned by the API.

Profile images are not embedded — clients fetch them from GET /api/v1/{icon} when icon is Some.

object
email
required
string
first_name
required
string
icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null
id
required
string format: uuid
last_name
required
string
details
string | null
id
required
integer format: int64
item_identifier
required
string
item_title
string | null
link
required
string
notification_text
required
string
notification_type
required
string
Allowed values: AssignedRisk RiskChanged NewRiskComment NewLowRisk NewMediumRisk NewHighRisk NewCriticalRisk IncChanged NewSev1Inc NewSev2Inc NewSev3Inc NewFraudInc NewExtortionInc NewSabotageInc NewDataDisclosureInc NewCustomerTargetingInc NewResourceHijackingInc NewIncComment AssignedInc DowngradedInc InvitedToOrg RisksCreated IncidentsCreated RiskScoringSummary IncidentScoringSummary
read_at
string | null format: date-time
timestamp
required
string format: date-time
total
required
integer format: int64
total_unread
required
integer format: int64

401

Section titled “401 ”

Unauthorized

404

Section titled “404 ”

Could not retrieve notifications