Skip to main content

​
Comparing X API’s List members endpoints

The v2 List members endpoint group will replace the standard v1.1 GET lists/members, GET lists/memberships, POST lists/members/create and POST lists/members/destroy endpoints. If you have code, apps, or tools that use one of these versions of the List member endpoints, and are considering migrating to the newer X API v2 endpoint, then this set of guides is for you. 

​
List members lookup

The v2 List members lookup endpoints will replace the standard  GET lists/members, GET lists/memberships, endpoints. The following tables compare the standard v1.1 and X API v2 List endpoints: List member Lookup
DescriptionStandard v1.1X API v2
HTTP methods supportedGETGET
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/lists/members.json/2/lists/:id/members
AuthenticationOAuth 1.0a User Context

App only		OAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE

App only
Default request rate limits900 requests per 15 min with OAuth 1.0a

75 requests per 15min with App only		900 requests per 15 min with OAuth 1.0a

900 requests per 15 min with OAuth 2.0

900 requests per 15 min with App only
List membership lookup
DescriptionStandard v1.1X API v2
HTTP methods supportedGETGET
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/lists/memberships.json/2/users/:id/list_memberships
AuthenticationOAuth 1.0a User Context

App only		OAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE

App only
Default request rate limits75 requests per 15 min with OAuth 1.0a

75 requests per 15min with App only		75 requests per 15 min with OAuth 1.0a

75 requests per 15 min with OAuth 2.0

75 requests per 15min with App only

​
Manage List members

The v2 manage List members endpoints will replace the standard POST lists/members/create, POST lists/members/destroy endpoints. The following tables compare the standard v1.1 and X API v2 List endpoints: Add member
DescriptionStandard v1.1X API v2
HTTP methods supportedPOSTPOST
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/lists/members/create.json/2/lists/:id/members
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE
Default request rate limitsNone300 requests per 15 min (per user)
Remove member
DescriptionStandard v1.1X API v2
HTTP methods supportedPOSTDELETE
Host domainhttps://api.x.comhttps://api.x.com
Endpoint path/1.1/lists/members/destroy.json/2/lists/:id/:user_id
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE
Default request rate limitsNone300 requests per 15 min (per user)
To access the X API v2 endpoints, you must sign up for a developer account. When authenticating, you must use keys and tokens from a developer App that is located within a Project.  Learn more about getting access to the X API v2 endpoints in our getting started page.
⌘I