> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-508d47e7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# List Lookup
> The List lookup endpoints let you retrieve information about Lists. Reference for the X API v2 standard tier covering list lookup.
export const Button = ({href, children}) => {
return ;
};
The List lookup endpoints let you retrieve information about Lists. Look up a specific List by ID or get all Lists owned by a user.
## Overview
Get details for a specific List
Get all Lists owned by a user
***
## Endpoints
| Method | Endpoint | Description |
| :- | :- | :- |
| GET | [`/2/lists/:id`](/x-api/lists/get-list-by-id) | Get List by ID |
| GET | [`/2/users/:id/owned_lists`](/x-api/users/get-owned-lists) | Get Lists owned by a user |
***
## Response fields
By default, the response includes `id` and `name`. Request additional fields:
| Field | Description |
| :- | :- |
| `description` | List description |
| `owner_id` | Owner's user ID |
| `private` | Whether List is private |
| `follower_count` | Number of followers |
| `member_count` | Number of members |
| `created_at` | List creation date |
### Example request
```bash theme={null}
curl "https://api.x.com/2/lists/1234567890?\
list.fields=description,owner_id,member_count,follower_count" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
***
## Getting started
**Prerequisites**
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* Your App's [keys and tokens](/resources/fundamentals/authentication)
Make your first List lookup request
Key concepts and best practices
Full endpoint documentation
Working code examples