> ## 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.
# Pinned Lists Overview
> The pinned Lists endpoints let you look up a user's pinned Lists and manage which Lists are. Reference for the X API v2 standard tier covering quickstart.
export const Button = ({href, children}) => {
return ;
};
The pinned Lists endpoints let you look up a user's pinned Lists and manage which Lists are pinned.
**Prerequisites**
Before you begin, you'll need:
* A [developer account](https://developer.x.com/en/portal/petition/essential/basic-info) with an approved App
* User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)
***
## Available endpoints
Get your pinned Lists
Pin and unpin Lists
***
## Authentication
| Operation | Authentication |
| :------------------- | :--------------------------- |
| Look up pinned Lists | OAuth 1.0a or OAuth 2.0 PKCE |
| Pin/unpin Lists | OAuth 1.0a or OAuth 2.0 PKCE |
Both lookup and manage operations require user context authentication. App-only (Bearer Token) authentication is not supported.
***
## Quick example
```bash cURL theme={null}
# Get pinned Lists
curl "https://api.x.com/2/users/2244994945/pinned_lists" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Get pinned Lists
response = client.lists.get_pinned("2244994945")
for lst in response.data:
print(f"{lst.name}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Get pinned Lists
const response = await client.lists.getPinned("2244994945");
response.data?.forEach((lst) => {
console.log(lst.name);
});
```
***
## Next steps
Get List details
Create and update Lists