This endpoint was recently graduated from Twitter Developer Labs, and is the replacement of v1.1 GET users/show, v1.1 GET users/lookup, and Labs GET /users. If you are currently using any of these endpoints, you can use our migration materials to start working with this new endpoint. 

Learn more about the new Twitter API v2: Early Access.


The RESTful endpoint uses the GET method to return information about a user or group of users, specified by a user ID or a username. The response includes one or many user objects, which deliver fields such as the Follower count, location, pinned Tweet ID, and profile bio. Responses can also optionally include expansions to return the full Tweet object for a user’s pinned Tweet, including the Tweet text, author, and other Tweet fields. 

This endpoint is commonly used to receive up-to-date details on a user, to verify that a user exists, or to update your stored details following a compliance event.

To access this endpoint, you must have an approved developer account, and have activated the new developer portal. 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 Twitter API v2 endpoints in our "Getting started" page.

Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.