POST lists/destroy

Deletes the specified list. The authenticated user must own the list to be able to destroy it.

Resource URL

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes


Name Required Description Default Value Example
owner_screen_name optional The screen name of the user who owns the list being requested by a slug .
owner_id optional The user ID of the user who owns the list being requested by a slug .
list_id required The numerical id of the list.
slug required You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list owner using the owner_id or owner_screen_name parameters.

Example Request


Example Response

  "id": 1130194503435018247,
  "id_str": "1130194503435018247",
  "name": "Test List",
  "uri": "/TwitterDev/lists/test-list",
  "subscriber_count": 0,
  "member_count": 0,
  "mode": "public",
  "description": "This is a test list",
  "slug": "test-list",
  "full_name": "@TwitterDev/test-list",
  "created_at": "Sun May 19 19:32:22 +0000 2019",
  "following": false,
  "user": {
    "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": 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": "",
        "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": false,
        "has_extended_profile": null,
        "default_profile": false,
        "default_profile_image": false,
        "following": false,
        "follow_request_sent": false,
        "notifications": false,
        "translator_type": "null"