> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-smedina-x-calls-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# User Lookup
> The User lookup endpoints let you retrieve profile information for one or more users. Reference for the X API v2 standard tier covering lookup.
export const Button = ({href, children}) => {
return ;
};
The User lookup endpoints let you retrieve profile information for one or more users. Look up users by their ID, username, or get details for the currently authenticated user.
## Overview
Look up users by their unique user ID
Look up users by their @handle
Retrieve up to 100 users per request
Get details for the current user
***
## Endpoints
| Method | Endpoint | Description |
| :- | :- | :- |
| GET | [`/2/users/:id`](/x-api/users/get-user-by-id) | Get user by ID |
| GET | [`/2/users`](/x-api/users/get-users-by-ids) | Get users by IDs (up to 100) |
| GET | [`/2/users/by/username/:username`](/x-api/users/get-user-by-username) | Get user by username |
| GET | [`/2/users/by`](/x-api/users/get-users-by-usernames) | Get users by usernames (up to 100) |
| GET | [`/2/users/me`](/x-api/users/get-my-user) | Get authenticated user |
***
## Example request
```bash theme={null}
curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,public_metrics,verified" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
## Example response
```json title="Example response" lines wrap icon="https://mintcdn.com/x-preview-smedina-x-calls-api/-7OW7nsDWqK3AWJF/icons/xds/icon-brackets.svg?fit=max&auto=format&n=-7OW7nsDWqK3AWJF&q=85&s=dabfc3587bd4dd874742722c6da127e6" theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "XDevelopers",
"created_at": "2013-12-14T04:35:55.000Z",
"description": "The voice of the X developer community",
"verified": true,
"public_metrics": {
"followers_count": 583423,
"following_count": 2048,
"tweet_count": 14052,
"listed_count": 1672
}
}
}
```
***
## Getting started
**Prerequisites**
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* Your App's [keys and tokens](/resources/fundamentals/authentication)
Look up users by ID or username
Get the current user's profile
Key concepts and best practices
Full endpoint documentation