Skip to main content
This guide walks you through retrieving a user’s pinned Lists.
PrerequisitesBefore you begin, you’ll need:
  • A developer account with an approved App
  • User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

​
Get pinned Lists

1

Get your user ID

You need your authenticated user’s ID. You can find it using the user lookup endpoint or from your Access Token (the numeric part is your user ID).
2

Request pinned Lists

cURL
curl "https://api.x.com/2/users/2244994945/pinned_lists?\
list.fields=follower_count,member_count,owner_id&\
expansions=owner_id&\
user.fields=created_at,username" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
3

Review the response

{
  "data": [
    {
      "id": "1454155907651158017",
      "name": "Tech News",
      "follower_count": 150,
      "member_count": 25,
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "name": "X Developers",
        "created_at": "2013-12-14T04:35:55.000Z"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}

​
Available List fields

FieldDescription
descriptionList description
owner_idOwner’s user ID
privateWhether List is private
member_countNumber of members
follower_countNumber of followers
created_atList creation date

​
Next steps

Manage pinned Lists

Pin and unpin Lists

List lookup

Get List details

API Reference

Full endpoint documentation