Users

Get notifications

Returns your X account's notifications, else 424 account_required.

get/x/notifications

Query parameters

type'All' | 'Verified' | 'Mentions'

Notification type filter. Unrecognized values fall back to All.

cursorstring

Pagination cursor for notifications

Response

List of notifications

has_next_pageboolean required

next_cursorstring required

Example response

{
  "notifications": [
    {
      "id": "1234567890",
      "type": "like",
      "message": "elonmusk liked your tweet",
      "timestamp": "2025-01-15T12:00:00Z"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

Changes

Changed in 10 of the 32 revisions of this API.12005

Sep 27, 2026d9f0c903425520See the full diff
- ●
  added the new draw_too_large enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the /////// response property for the response status
  response-property-enum-value-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 26, 2026db02366a5e8d10See the full diff
- ●
  added the new bookmark_folders_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 25, 202621bb66373b8910See the full diff
- ●
  added the new search_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 24, 2026b52c1499267510See the full diff
- ●
  added the new idempotency_in_progress enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 19, 2026102d654209ab10See the full diff
- ●
  added the new likes_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 14, 2026904c3a9699c810See the full diff
- ●
  added the new pagination_stalled enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 9, 20260ecb877c65ca10See the full diff
- ●
  added the new x_reply_not_allowed enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the /////// response property for the response status
  response-property-enum-value-added
Aug 24, 20265b381ffca02c11See the full diff
- ▲
  the / response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added 'propertyNames' constraint to the / response property for the status
  response-property-property-names-added
Aug 19, 202673cd0a1d989c90See the full diff
- ●
  added the new closed enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the /////// response property for the response status
  response-property-enum-value-added
Aug 12, 2026d5855df0e349304See the full diff
- ●
  added the new coverage_cursor_gone enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the ////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the /////// response property for the response status (media type: application/json)
  response-property-enum-value-added
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/subscription/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[GuestPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property payment_options/guest_wallet/create_checkout/provider deprecated (media type: application/problem+json)
  response-property-deprecated

Full history