Overview
Comparing X API’s List Posts lookup endpoints
The v2 List Posts lookup endpoint will replace the standard v1.1 GET lists/statuses. If you have code, apps, or tools that use this version of the endpoint, and are considering migrating to the newer X API v2 endpoint, then this set of guides is for you.
The following tables compare the standard v1.1 and X API v2 List endpoints:
List Lookup by ID
| Description | Standard v1.1 | X API v2 |
| HTTP methods supported | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/lists/statuses.json | /2/lists/:id/tweets |
| Authentication | OAuth 1.0a User Context App only | OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE App only |
| Default request rate limits | 900 requests per 15 min with OAuth 1.0a 900 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 |
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.
Overview
Comparing X API’s List Posts lookup endpoints
The v2 List Posts lookup endpoint will replace the standard v1.1 GET lists/statuses. If you have code, apps, or tools that use this version of the endpoint, and are considering migrating to the newer X API v2 endpoint, then this set of guides is for you.
The following tables compare the standard v1.1 and X API v2 List endpoints:
List Lookup by ID
| Description | Standard v1.1 | X API v2 |
| HTTP methods supported | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/lists/statuses.json | /2/lists/:id/tweets |
| Authentication | OAuth 1.0a User Context App only | OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE App only |
| Default request rate limits | 900 requests per 15 min with OAuth 1.0a 900 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 |
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.