GET lists/memberships

Returns the lists the specified user has been added to. If user_id or screen_name are not provided, the memberships for the authenticating user are returned.

Resource URL

https://api.twitter.com/1.1/lists/memberships.json

Resource Information

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

Parameters

Name Required Description Default Value Example
user_id optional The ID of the user for whom to return results. Helpful for disambiguating when a valid user ID is also a valid screen name.
screen_name optional The screen name of the user for whom to return results. Helpful for disambiguating when a valid screen name is also a user ID.
count optional The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
cursor optional Breaks the results into pages. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. It is recommended to always use cursors when the method supports them. See Cursoring for more information.
filter_to_owned_lists optional When set to true , t or 1 , will return just lists the authenticating user owns, and the user represented by user_id or screen_name is a member of.

Example Request

GET https://api.twitter.com/1.1/lists/memberships.json?screen_name=twitterdev

Example Response

{
  "next_cursor": 1631626924518660544,
  "next_cursor_str": "1631626924518660544",
  "previous_cursor": 0,
  "previous_cursor_str": "0",
  "lists": [
    {
      "id": 1130185227375038465,
      "id_str": "1130185227375038465",
      "name": "Twitter API",
      "uri": "/twitterdev/lists/twitter-api",
      "subscriber_count": 0,
      "member_count": 2,
      "mode": "public",
      "description": "",
      "slug": "twitter-api",
      "full_name": "@twitterdev/twitter-api",
      "created_at": "Sun May 19 18:55:30 +0000 2019",
      "following": true,
      "user": {
        "id": 2244994945,
        "id_str": "2244994945",
        "name": "Twitter Dev",
        "screen_name": "TwitterDev",
        "location": "The Internet",
        "description": "",
        "url": null,
        "entities": {
          "description": {
            "urls": []
          }
        },
      "protected": false,
      "followers_count": 502084,
      "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": "https://pbs.twimg.com/profile_images/880136122604507136/xHrnqf1T_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1498675817",
      "profile_link_color": "null",
      "profile_sidebar_border_color": "null",
      "profile_sidebar_fill_color": "null",
      "profile_text_color": "null",
      "profile_use_background_image": false,
      "has_extended_profile": null,
      "default_profile": false,
      "default_profile_image": false,
      "following": false,
      "follow_request_sent": false,
      "notifications": false,
      "translator_type": "null"
      }
    }  ]
}