Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

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