Notification

Example

[
  {
    "id": "34975861",
    "type": "mention",
    "created_at": "2019-11-23T07:49:02.064Z",
    "account": {
      "id": "971724",
      "username": "zsc",
      "acct": "zsc",
      ...
    },
    "status": {
      "id": "103186126728896492",
      "created_at": "2019-11-23T07:49:01.940Z",
      "in_reply_to_id": "103186038209478945",
      "in_reply_to_account_id": "14715",
      ...
    }
  },
  {
    "id": "34975535",
    "type": "favourite",
    "created_at": "2019-11-23T07:29:18.903Z",
    "account": {
      "id": "297420",
      "username": "haskal",
      "acct": "haskal@cybre.space",
      ...
    },
    "status": {
      "id": "103186046267791694",
      "created_at": "2019-11-23T07:28:34.210Z",
      ...
      },
      "account": {
        "id": "14715",
        "username": "trwnh",
        "acct": "trwnh",
        ...
      },
      ...
    }
  },
  ...
]

Required attributes

id

Description: The id of the notification in the database.
Type: String (cast from an integer, but not guaranteed to be a number)
Version history:
0.9.9 - added

type

Description: The type of event that resulted in the notification.
Type: String (Enumerable oneOf)
follow = Someone followed you
follow_request = Someone requested to follow you
mention = Someone mentioned you in their status
reblog = Someone boosted one of your statuses
favourite = Someone favourited one of your statuses
poll = A poll you have voted in or created has ended
status = Someone you enabled notifications for has posted a status
Version history:
0.9.9 - added
2.8.0 - added poll
3.1.0 - added follow_request
3.3.0 - added status

created_at

Description: The timestamp of the notification.
Type: String (ISO 8601 Datetime)
Version history:
0.9.9 - added

account

Description: The account that performed the action that generated the notification.
Type: Account
Version history:
0.9.9 - added

Optional attributes

status

Description: Status that was the object of the notification, e.g. in mentions, reblogs, favourites, or polls.
Type: Status
Version history:
0.9.9 - added

See also

Last updated December 27, 2020 · Improve this page