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

# Enterprise user lookup v2 migration

> Compare Standard v1.1 users/show and users/lookup endpoints with the X API v2 user lookup endpoints, including fields, expansions, and 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>;
};

## Comparing X API’s users lookup endpoints

The v2 user lookup endpoints will replace the standard v1.1 [GET users/lookup](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup.html) and [GET users/show](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-show.html) endpoints. If you have code, apps, or tools that use one of these versions of the user lookup endpoints, and are considering migrating to the newer X API v2 endpoint, then this set of guides is for you. 
 

The following tables compare the various types of users lookup endpoints:
 

|                                                                                                                                                                    |                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                       |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **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/users/show.json` `/1.1/users/lookup.json`                                                                                            | `/2/users`<br /><br />`/2/users/:id`<br /><br />`/2/users/by`<br /><br />`/2/users/by/:username`                                                                                                                                                                                                                                                      |
| [Authentication](/resources/fundamentals/authentication)                                                                                                           | OAuth 1.0a User Context                                                                                                                    | OAuth 1.0a User Context<br /><br />App only<br /><br />OAuth 2.0 Authorization Code with PKCE                                                                                                                                                                                                                                                         |
| Default request [rate limits](/resources/fundamentals/rate-limits)                                                                                                 | 900 requests per 15 min (per user)<br /><br />/show - 900 requests per 15 min (per app)  <br />/lookup - 300 requests per 15 min (per app) | 900 requests per 15 min (per user)<br /><br />300 requests per 15 min (per app)                                                                                                                                                                                                                                                                       |
| Maximum Users per response                                                                                                                                         | /show -  1<br /><br />/lookup - 100                                                                                                        | 100                                                                                                                                                                                                                                                                                                                                                   |
| JSON response object format                                                                                                                                        | Standard v1.1 format                                                                                                                       | [X API v2 format](/x-api/fundamentals/data-dictionary) (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats)<br /><br />To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our [data formats migration guide](/x-api/migrate/data-format-migration). |
| Supports selecting which [fields](/x-api/fundamentals/data-dictionary) return in the payload                                                                       |                                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports the [annotations](/x-api/fundamentals/post-annotations) fields (on pinned Post)                                                                           |                                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports requesting new [metrics](/x-api/fundamentals/metrics) fields (on pinned Post)                                                                             |                                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports the [conversation\_id](/x-api/fundamentals/conversation-id) field (on pinned Post)                                                                        |                                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Requires the use of credentials from a [developer App](/resources/fundamentals/developer-apps) associated with a [project](/resources/fundamentals/developer-apps) |                                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                     |

**Other migration resources**

[User lookup: Standard v1.1 to X API v2](/x-api/users/lookup/migrate/standard-to-twitter-api-v2)

[X API migration hub](/x-api/migrate/overview)

[Check out some sample code for these endpoints](https://github.com/xdevplatform/Twitter-API-v2-sample-code "Check out some sample code for these endpoints")