Pinned Lists Lookup

Get a user’s pinned Lists

This guide walks you through retrieving a user’s pinned Lists.

Prerequisites

Before 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

   shellscript

   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

Field	Description
description	List description
owner_id	Owner’s user ID
private	Whether List is private
member_count	Number of members
follower_count	Number of followers
created_at	List creation date

---

Next steps

Manage pinned Lists

Pin and unpin Lists

List lookup

Get List details

API Reference

Full endpoint documentation