> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X API v2 authentication mapping

> The following chart illustrates which v2 endpoints map to what authentication methods. Documentation for the X developer platform covering v2 authentication.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

The following chart illustrates which v2 endpoints map to what authentication methods. 
 

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                             |                                     |                                                                                                                                              |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------- | :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| **Endpoint**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | **OAuth 1.0a User Context** | **OAuth 2.0** **App Only   <br />** | **OAuth 2.0  <br />Authorization Code with PKCE**                                                                                            |
| [Tweet lookup](/x-api/posts/lookup/introduction)<br /><br />Retrieve multiple Tweets with a list of IDs<br /><br />[GET /2/tweets](/x-api/posts/post-lookup-by-post-ids)<br /><br />Retrieve a single Tweet with an ID<br /><br />[GET /2/tweets/:id](/x-api/posts/post-lookup-by-post-id)                                                                                                                                                                                                                                                                                                                                                        | ✅                           | ✅                                   | ✅  <br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read                                                                           |
| [Manage Tweets](/x-api/posts/manage-tweets/introduction)<br /><br />Post a Tweet<br /><br />[POST /2/tweets](/x-api/posts/creation-of-a-post)<br /><br />Delete a Tweet<br /><br />[DELETE /2/tweets/:id](/x-api/posts/post-delete-by-post-id)                                                                                                                                                                                                                                                                                                                                                                                                    | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />tweet.write<br /><br />users.read                                                      |
| [Timelines](/x-api/posts/timelines/introduction)<br /><br />User Tweet timeline<br /><br />[GET /2/users/:id/tweets](/x-api/users/get-posts)<br /><br />User mention timeline<br /><br />[GET /2/users/:id/mentions](/x-api/users/get-mentions)<br /><br />Reverse chronological home timeline<br /><br />[GET /2/users/:id/timelines/reverse\_cronological](/x-api/posts/timelines#user-mention-timeline-3)                                                                                                                                                                                                                                      | ✅<br /><br />✅              | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read |
| [Recent search](/x-api/posts/search/introduction#recent-search)<br /><br />Search for Tweets published in the last 7 days<br /><br />[GET /2/tweets/search/recent](/x-api/posts/recent-search)                                                                                                                                                                                                                                                                                                                                                                                                                                                    | ✅                           | ✅                                   | ✅<br /><br />Scopes: <br /><br />tweet.read<br /><br />users.read                                                                            |
| [Full-archive search](/x-api/posts/search/introduction#full-archive-search)<br /><br />Only available to those with Academic Research access<br /><br />Search the full archive of Tweets<br /><br />[GET /2/tweets/search/all](/x-api/posts/full-archive-search)                                                                                                                                                                                                                                                                                                                                                                                 |                             | ✅                                   |                                                                                                                                              |
| [Filtered stream](/x-api/posts/filtered-stream/introduction)<br /><br />Add or delete rules from your stream<br /><br />[POST /2/tweets/search/stream/rules](/x-api/stream/update-stream-rules)<br /><br />Retrieve your stream's rules<br /><br />[GET /2/tweets/search/stream/rules](/x-api/stream/get-stream-rules)<br /><br />Connect to the stream<br /><br />[GET /2/tweets/search/stream](/x-api/posts/filtered-stream)                                                                                                                                                                                                                    |                             | ✅                                   |                                                                                                                                              |
| [Volume streams](/x-api/posts/volume-streams/introduction)<br /><br />Streams about 1% of all Tweets in real-time.<br /><br />[GET /2/tweets/sample/stream](/x-api/stream/stream-sampled-posts)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                             | ✅                                   |                                                                                                                                              |
| [Manage Retweets](/x-api/posts/retweets/introduction#manage-retweets)<br /><br />Retweet a Tweet<br /><br />[POST /2/users/:id/retweets](/x-api/posts/retrieve-posts-that-repost-a-post)<br /><br />Delete a Retweet<br /><br />[DELETE /2/users/:id/retweets/:source\_tweet\_id](/x-api/users/unrepost-post)                                                                                                                                                                                                                                                                                                                                     | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />tweet.write<br /><br />users.read                                                      |
| [Retweets lookup](/x-api/posts/retweets/introduction#retweets-lookup)<br /><br />Users who have Retweeted a Tweet<br /><br />[GET /2/tweets/:id/retweeted\_by](/x-api/posts/get-reposted-by)                                                                                                                                                                                                                                                                                                                                                                                                                                                      | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read                                                                             |
| Bookmarks [lookup](/x-api/posts/bookmarks/introduction#bookmarks-lookup)<br /><br />Get bookmarked Tweets<br /><br />[GET /2/tweets/:id/bookmarks](/x-api/bookmarks/bookmarks-by-user)                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                             |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />bookmark.read                                                    |
| [Manage Bookmarks](/x-api/posts/bookmarks/introduction#manage-bookmarks)<br /><br />Bookmark a Tweet<br /><br />[POST /2/tweets/:id/bookmarks](/x-api/bookmarks/add-post-to-bookmarks)<br /><br />Remove a Bookmark of a Tweet<br /><br />[DELETE /2/users/:id/bookmarks:tweet\_id](/x-api/bookmarks/remove-a-bookmarked-post)                                                                                                                                                                                                                                                                                                                    |                             |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />bookmark.write                                                   |
| [Manage Likes](/x-api/posts/likes/introduction#manage-likes)<br /><br />Like a Tweet<br /><br />[POST /2/users/:id/likes](/x-api/users/like-post)<br /><br />Undo a Like of a Tweet<br /><br />[DELETE /2/users/:id/likes/:tweet\_id](/x-api/users/unlike-post)                                                                                                                                                                                                                                                                                                                                                                                   | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />like.write                                                       |
| [Likes lookup](/x-api/posts/likes/introduction#likes-lookup)<br /><br />Users who have liked a Tweet<br /><br />[GET /2/tweets/:id/liking\_users](/x-api/posts/get-liking-users)<br /><br />Tweets liked by a user<br /><br />[GET /2/users/:id/liked\_tweets](/x-api/users/get-liked-posts)                                                                                                                                                                                                                                                                                                                                                      | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />like.read                                                        |
| [Hide replies](/x-api/posts/hide-replies/introduction)<br /><br />Hides or unhides a reply to a Tweet.<br /><br />[PUT /2/tweets/:id/hidden](/x-api/posts/hide-replies)                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />tweet.moderate.write                                             |
| [Users lookup](/x-api/users/lookup/introduction)<br /><br />Retrieve multiple users with IDs<br /><br />[GET /2/users](/x-api/users/user-lookup-by-ids)<br /><br />Retrieve a single user with an ID<br /><br />[GET /2/users/:id](/x-api/users/user-lookup-by-id)<br /><br />Retrieve multiple users with usernames<br /><br />[GET /2/users/by](/x-api/users/user-lookup-by-usernames)<br /><br />Retrieve a single user with a username<br /><br />[GET /2/users/by/username/:username](/x-api/users/user-lookup-by-username)<br /><br />Get information about an authenticated user<br /><br />[GET /2/users/me](/x-api/users/user-lookup-me) | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read                                                                             |
| [Manage follows](/x-api/users/follows/introduction#manage-follows)<br /><br />Allows a user ID to follow another user<br /><br />[POST /2/users/:id/following](/x-api/users/follow-user)<br /><br />Allows a user ID to unfollow another user<br /><br />[DELETE /2/users/:source\_user\_id/following/:target\_user\_id](/x-api/users/unfollow-user)                                                                                                                                                                                                                                                                                              | ✅                           |                                     | ✅<br /><br />Scopes: <br /><br />tweet.read<br /><br />users.read<br /><br />follows.write                                                   |
| [Follows lookup](/x-api/users/follows/introduction#follows-lookup)<br /><br />Lookup following of a user by ID<br /><br />[GET /2/users/:id/following](/x-api/users/following-by-user-id)<br /><br />Lookup followers of a user by ID<br /><br />[GET /2/users/:id/followers](/x-api/users/followers-by-user-id)                                                                                                                                                                                                                                                                                                                                  | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />follows.read                                                     |
| [Blocks lookup](/x-api/users/blocks/introduction#blocks-lookup)<br /><br />Returns a list of users who are blocked by the specified user ID <br /><br />[GET /2/users/:id/blocking](/x-api/users/returns-user-objects-that-are-blocked-by-provided-user-id)                                                                                                                                                                                                                                                                                                                                                                                       | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />block.read                                                       |
| [Manage Mutes](/x-api/users/mutes/introduction#manage-mutes)<br /><br />Allows a user ID to mute another user<br /><br />[POST /2/users/:id/muting](/x-api/users/mute-user-by-user-id)<br /><br />Allows a user ID to unmute another user<br /><br />[DELETE /2/users/:source\_user\_id/muting/:target\_user\_id](/x-api/users/unmute-user-by-user-id)                                                                                                                                                                                                                                                                                            | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />mute.write                                                       |
| [Mutes lookup](/x-api/users/mutes/introduction#mutes-lookup)<br /><br />Returns a list of users who are muted by the specified user ID<br /><br />[GET /2/users/:id/muting](/x-api/users/returns-user-objects-that-are-muted-by-the-provided-user-id)                                                                                                                                                                                                                                                                                                                                                                                             | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />mute.read                                                        |
| [Spaces lookup](/x-api/spaces/lookup/introduction)<br /><br />Lookup Space by ID<br /><br />[GET /2/spaces/:id](/x-api/spaces/space-lookup-by-space-id)<br /><br />Lookup multiple Spaces <br /><br />[GET /2/spaces](/x-api/spaces/space-lookup-up-space-ids)<br /><br />Discover Spaces created by user ID<br /><br />[GET /2/spaces/by/creator\_ids](/x-api/spaces/space-lookup-by-their-creators)                                                                                                                                                                                                                                             |                             | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />space.read                                                       |
| [Spaces lookup](/x-api/spaces/lookup/introduction)<br /><br />Get users who purchased a ticket to a Space<br /><br />[GET /2/spaces/:id/buyers](/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space)                                                                                                                                                                                                                                                                                                                                                                                                               |                             |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />space.read                                                       |
| [Spaces search](/x-api/spaces/search/introduction)<br /><br />Returns live or scheduled Spaces matching your specified search terms.<br /><br />[GET /2/spaces/search](/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                                                                                                                                                                           |                             | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />space.read                                                       |
| [List lookup](/x-api/lists/list-lookup/introduction)<br /><br />Lookup a specific list by ID<br /><br />[GET /2/lists/:id](/x-api/lists/list-lookup-by-list-id)<br /><br />Lookup a user's owned List<br /><br />[GET /2/users/:id/owned\_lists](/x-api/users/get-owned-lists)                                                                                                                                                                                                                                                                                                                                                                    | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.read                                                        |
| [Manage Lists](/x-api/lists/manage-lists/introduction)<br /><br />Creates a new List on behalf of an authenticated user<br /><br />[POST /2/lists](/x-api/lists/create-list)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.read<br /><br />list.write                                  |
| [Manage Lists](/x-api/lists/manage-lists/introduction)<br /><br />Deletes a List the authenticated user owns<br /><br />[DELETE /2/lists/:id](/x-api/lists/delete-list)<br /><br />Updates the metadata for a List the authenticated user owns<br /><br />[PUT /2/lists/:id](/x-api/lists/update-list)                                                                                                                                                                                                                                                                                                                                            | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.write                                                       |
| [List Tweets lookup](/x-api/lists/list-tweets/introduction)<br /><br />Lookup Tweets from a specified List<br /><br />[GET /2/lists/:id/tweets](/x-api/lists/get-list-posts)                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.read                                                        |
| [List members lookup](/x-api/lists/list-members/introduction#list-members-lookup)<br /><br />Returns a list of members from a specified List<br /><br />[GET /2/lists/:id/members](/x-api/lists/get-list-members)<br /><br />Returns all Lists a specified user is a member of<br /><br />[GET /2/users/:id/list\_memberships](/x-api/users/get-list-memberships)                                                                                                                                                                                                                                                                                 | ✅                           | ✅                                   | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.read                                                        |
| [Manage List members](/x-api/lists/list-members/introduction#manage-list-members)<br /><br />Add a member to a List that the authenticated user owns<br /><br />[POST /2/lists/:id/members](/x-api/lists/add-list-member)<br /><br />Removes a member from a List the authenticated user owns<br /><br />[DELETE /2/lists/:id/members/:user\_id](/x-api/lists/remove-a-list-member)                                                                                                                                                                                                                                                               | ✅                           |                                     | ✅<br /><br />Scopes:<br /><br />tweet.read<br /><br />users.read<br /><br />list.write                                                       |
| [List follows lookup](/x-api/lists/list-lookup/introduction)<br /><br />Returns all followers of a specified List<br /><br />[GET /2/lists/:id/followers](/x-api/lists/get-list-followers)<br /><br />Returns all Lists a specified user follows<br /><br />[GET /2/users/:id/followed\_lists](/x-api/users/get-followed-lists)                                                                                                                                                                                                                                                                                                                   | ✅                           | ✅                                   | ✅<br /><br />Scope                                                                                                                           |