> ## 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

> The Pinned Lists endpoints let you view, pin, and unpin Lists for the authenticated user. Reference for the X API v2 standard tier covering pinned lists.

The Pinned Lists endpoints let you view, pin, and unpin Lists for the authenticated user. Pinned Lists appear prominently in the user's X interface.

## Overview

> [card] View pinned
>
> Get user's pinned Lists

> [card] Pin List
>
> Pin a List

> [card] Unpin List
>
> Unpin a List

***

## Endpoints

| Method | Endpoint | Description |
| :- | :- | :- |
| GET | [`/2/users/:id/pinned_lists`](https://docs.x.com/x-api/users/get-pinned-lists) | Get pinned Lists |
| POST | [`/2/users/:id/pinned_lists`](https://docs.x.com/x-api/users/pin-list) | Pin a List |
| DELETE | [`/2/users/:id/pinned_lists/:list_id`](https://docs.x.com/x-api/users/unpin-list) | Unpin a List |

***

## Example: Get pinned Lists

```bash theme={null}
curl "https://api.x.com/2/users/123456789/pinned_lists?\
list.fields=name,description,member_count" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
```

## Example: Pin a List

```bash theme={null}
curl -X POST "https://api.x.com/2/users/123456789/pinned_lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"list_id": "9876543210"}'
```

***

## Getting started

> [!NOTE]
>
> **Prerequisites**
>
> * An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
> * A [Project and App](https://docs.x.com/resources/fundamentals/developer-apps.md) in the Developer Console
> * User Access Tokens via [OAuth 2.0 PKCE](https://docs.x.com/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2)

> [card] [Lookup quickstart](https://docs.x.com/x-api/lists/pinned-lists/quickstart/pinned-list-lookup.md)
>
> Get pinned Lists

> [card] [Manage quickstart](https://docs.x.com/x-api/lists/pinned-lists/quickstart/manage-pinned-lists.md)
>
> Pin and unpin Lists

> [card] [Integration guide](https://docs.x.com/x-api/lists/pinned-lists/integrate.md)
>
> Key concepts and best practices

> [card] [API Reference](https://docs.x.com/x-api/users/get-pinned-lists.md)
>
> Full endpoint documentation
