GET mutes/users/list

Returns an array of user objects the authenticating user has muted.

Resource URL

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes
Requests / 15-min window (user auth) 15


Name Required Description Default Value Example
cursor optional

Causes the list of IDs to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out. If no cursor is provided, a value of -1 will be assumed, which is the first "page."

The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.

-1 2
include_entities optional The entities node will not be included when set to false . true false
skip_status optional When set to either true , t or 1 statuses will not be included in the returned user objects. false true

Example Request


Example Response

  "users": [
      "id": 2244994945,
      "id_str": "2244994945",
      "name": "Twitter Dev",
      "screen_name": "TwitterDev",
      "location": "Internet",
      "description": "Your official source for Twitter Platform news, updates & events. Need technical help? Visit ⌨️ #TapIntoTwitter",
      "url": "",
      "entities": {
        "url": {
          "urls": [
              "url": "",
              "expanded_url": "",
              "display_url": "",
              "indices": [
        "description": {
          "urls": [
              "url": "",
              "expanded_url": "",
              "display_url": "",
              "indices": [
      "protected": false,
      "followers_count": 502086,
      "friends_count": 1472,
      "listed_count": 1514,
      "created_at": "Sat Dec 14 04:35:55 +0000 2013",
      "favourites_count": 2203,
      "utc_offset": null,
      "time_zone": null,
      "geo_enabled": true,
      "verified": true,
      "statuses_count": 3393,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": null,
      "profile_background_color": "null",
      "profile_background_image_url": "null",
      "profile_background_image_url_https": "null",
      "profile_background_tile": null,
      "profile_image_url": "null",
      "profile_image_url_https": "",
      "profile_banner_url": "",
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": null,
      "has_extended_profile": null,
      "default_profile": false,
      "default_profile_image": false,
      "following": false,
      "live_following": false,
      "follow_request_sent": false,
      "notifications": false,
      "muting": false,
      "blocking": true,
      "blocked_by": false,
      "translator_type": "null"
  "next_cursor": 0,
  "next_cursor_str": "0",
  "previous_cursor": 0,
  "previous_cursor_str": "0",
  "total_count": null