Retrieve Users with Get Users by Email Endpoint

Learn how to retrieve lists of users using the get-users-by-email endpoint.

The GET /api/v2/users-by-email endpoint allows you to search for users using their email addresses. The search looks for an exact match to the provided email address and is case-sensitive.

This endpoint is immediately consistent, and as such, we recommend that you use this endpoint for:

• User searches run during the authentication process.
• User searches run as part of the account linking process.

The request must include a Management API access token.

Request example

Required Scopes: read:users

[
  {
    "email": "[e-mail]",
    "email_verified": false,
    "username": "johndoe",
    "phone_number": "[phone]",
    "phone_verified": false,
    "user_id": "usr_5457edea1b8f33391a000004",
    "created_at": "",
    "updated_at": "",
    "identities": [
      {
        "connection": "Initial-Connection",
        "user_id": "5457edea1b8f22891a000004",
        "provider": "auth0",
        "isSocial": false
      }
    ],
    "app_metadata": {},
    "user_metadata": {},
    "picture": "",
    "name": "",
    "nickname": "",
    "multifactor": [
      ""
    ],
    "last_ip": "",
    "last_login": "",
    "logins_count": 0,
    "blocked": false,
    "given_name": "",
    "family_name": ""
  }
]