GET
/
2
/
lists
/
{id}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The ID of the List.

Query Parameters

list.fields
enum<string>[]

A comma separated list of List fields to display.

Available options:
created_at,
description,
follower_count,
id,
member_count,
name,
owner_id,
private
expansions
enum<string>[]

A comma separated list of fields to expand.

Available options:
owner_id
user.fields
enum<string>[]

A comma separated list of User fields to display.

Available options:
affiliation,
connection_status,
created_at,
description,
entities,
id,
location,
most_recent_tweet_id,
name,
pinned_tweet_id,
profile_banner_url,
profile_image_url,
protected,
public_metrics,
receives_your_dm,
subscription_type,
url,
username,
verified,
verified_type,
withheld

Response

200 - application/json
data
object

A X List is a curated group of accounts.

errors
object[]
includes
object
Causes DMs to/from the target User (in the path) to be unblocked by the authenticated request userGet User's Followed Lists