List Lookup

The List lookup endpoints let you retrieve information about Lists. Reference for the X API v2 standard tier covering list lookup.

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

By ID

Get details for a specific List

By owner

Get all Lists owned by a user

---

Endpoints

Method	Endpoint	Description
GET	/2/lists/:id	Get List by ID
GET	/2/users/:id/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

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
• A Project and App in the Developer Console
• Your App’s keys and tokens

Quickstart

Make your first List lookup request

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation

Sample code

Working code examples