Skip to content
Esc
navigateopen⌘Jpreview
Dashboard

Get users by account info

Get users by email, phoneNumber or thirdParty info

GET/appid-{appId}/{tenantId}/users/by-accountinfo
Authorization
api-keyAPI key · headerrequired
The core service API token. If you are using a self-hosted core service and you have not generated a token, you can omit the header.
Path parameters
tenantIdstring
The tenant against which the request is made. If left empty, the default tenant will be used.
Query parameters
emailstring
phoneNumberstring
thirdPartyIdstring
thirdPartyUserIdstring
doUnionOfAccountInfobooleanrequired
Header parameters
cdi-versionstring
X.Y of the X.Y.Z CDI version.
Responses
200The operation was successful
statusstatusOK
Allowed:OK
usersauthRecipeUser[]
Show properties
Array of authRecipeUser
iduserId
isPrimaryUserboolean
tenantIdstenantId[]
timeJoinedtimeJoined
emailsemail[]
phoneNumbersphoneNumber[]
thirdPartyobject[]
Show properties
Array of object
idthirdPartyId
userIdthirdPartyUserId
loginMethodsobject[]
Show properties
Array of object
tenantIdstenantId[]
recipeUserIduserId
verifiedboolean
timeJoinedtimeJoined
recipeIdrecipeId
Allowed:emailpasswordpasswordlessthirdparty
emailemail
phoneNumberphoneNumber
thirdPartyobject
Show properties
idthirdPartyId
userIdthirdPartyUserId
400error code 400
string
401error code 401
string
404error code 404
string
500error code 500
string
Try it
Server
Authorization
Parameters
Request
curl -X GET "/appid-{appId}/public/users/by-accountinfo?doUnionOfAccountInfo=true" \
  -H "api-key: YOUR_API_KEY"
Response
{
  "status": "OK",
  "users": [
    {
      "id": "fa7a0841-b533-4478-95533-0fde890c3483",
      "isPrimaryUser": true,
      "tenantIds": [
        "customer1"
      ],
      "timeJoined": 1623918032231,
      "emails": [
        "johndoe@gmail.com"
      ],
      "phoneNumbers": [
        "+14155552671"
      ],
      "thirdParty": [
        {
          "id": "google",
          "userId": 106347997792363870000
        }
      ],
      "loginMethods": [
        {
          "tenantIds": [
            "customer1"
          ],
          "recipeUserId": "fa7a0841-b533-4478-95533-0fde890c3483",
          "verified": true,
          "timeJoined": 1623918032231,
          "recipeId": "emailpassword",
          "email": "johndoe@gmail.com",
          "phoneNumber": "+14155552671",
          "thirdParty": {
            "id": "google",
            "userId": 106347997792363870000
          }
        }
      ]
    }
  ]
}

API reference

API schema and response details