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
curl --request GET \
  --url 'https://{yourDomain}/api/v2/users-by-email?email=%7BuserEmailAddress%7D' \
  --header 'authorization: Bearer {yourMgmtApiAccessToken}'
[
  {
    "email": "john.doe@gmail.com",
    "email_verified": false,
    "username": "johndoe",
    "phone_number": "+199999999999999",
    "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": ""
  }
]