List Members Overview

The List members endpoints let you look up members of a List and manage List membership. Reference for the X API v2 standard tier covering quickstart.

The List members endpoints let you look up members of a List and manage List membership.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• Your App’s Bearer Token (for lookups)
• User Access Token (for managing members)

---

Available endpoints

List members lookup

Get members of a List

Manage List members

Add and remove members

---

Authentication

Operation	Authentication
Look up members	Bearer Token, OAuth 1.0a, or OAuth 2.0 PKCE
Add/remove members	OAuth 1.0a or OAuth 2.0 PKCE

---

Quick example

cURL

shellscript

# Get List members
curl "https://api.x.com/2/lists/84839422/members" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Get List members
for page in client.lists.get_members("84839422"):
    for user in page.data:
        print(f"{user.username}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Get List members
const paginator = client.lists.getMembers("84839422");

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(user.username);
  });
}

---

Next steps

List lookup

Get List details

List Posts

Get Posts from a List