Skip to content
Esc
navigateopen⌘Jpreview
Dashboard

Get passwordless user

Get a user’s information.

API is tenant specific if querying by email or phone number. If querying by userId, tenantId will be ignored.

Note that there is an invisible character at the end of the path, this was to avoid a conflict with the OpenAPI spec.

GET/appid-{appId}/{tenantId}/recipe/user ⠀deprecated
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
userIdstring
emailemail
Use exactly one of phoneNumber, email or userId
phoneNumberphoneNumber
Use exactly one of phoneNumber, email or userId
Header parameters
ridstring
cdi-versionstring
X.Y of the X.Y.Z CDI version.
Responses
200Get a user's information.
One of:
object
statusstatusOK
Allowed:OK
userauthRecipeUser
Show properties
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
object
statusstring
Allowed:UNKNOWN_USER_ID_ERRORUNKNOWN_EMAIL_ERRORUNKNOWN_PHONE_NUMBER_ERROR
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/recipe/user ⠀" \
  -H "api-key: YOUR_API_KEY"
Response
{
  "status": "OK",
  "user": {
    "id": "fa7a0841-b533-4478-95533-0fde890c3483",
    "isPrimaryUser": true,
    "tenantIds": [
      "customer1"
    ],
    "timeJoined": 1623918032231,
    "emails": [
      "[email protected]"
    ],
    "phoneNumbers": [
      "+14155552671"
    ],
    "thirdParty": [
      {
        "id": "google",
        "userId": 106347997792363870000
      }
    ],
    "loginMethods": [
      {
        "tenantIds": [
          "customer1"
        ],
        "recipeUserId": "fa7a0841-b533-4478-95533-0fde890c3483",
        "verified": true,
        "timeJoined": 1623918032231,
        "recipeId": "emailpassword",
        "email": "[email protected]",
        "phoneNumber": "+14155552671",
        "thirdParty": {
          "id": "google",
          "userId": 106347997792363870000
        }
      }
    ]
  }
}

API reference

API schema and response details