user.find

The user.find command is used to retrieve a user by email address.

TR50 Request


                        {
  "cmd": {
    "command": "user.find",
    "params": {
      "emailAddress": "user@example.com"
    }
  }
}
      

Request Parameters

Name

Type

Required

Description

emailAddress

String

Yes

The email address of the user.

TR50 Response

If the command is sent successfully a success message and the user is returned. Otherwise, an error and error message will be returned.


                        {
  "cmd": {
    "success": true,
    "params": {
      "id": "52a1d3db169e1fd03217940d",
      "emailAddress": "user@example.com",
      "defaultOrgId": "fd03217940d52a1d3db169e1",
      "firstName": "Jane",
      "lastName": "Smith",
      "company": "Acme",
      "title": "CEO",
      "officePhone": "5558675309",
      "mobilePhone": "5558675309",
      "isSuperAdmin": false,
      "isSuperOps": false,
      "createdBy": "SYSTEM",
      "createdOn": "2013-12-06T08:40:43.885-05:00",
      "updatedBy": "SYSYEM",
      "updatedOn": "2013-12-06T08:40:43.885-05:00"
    }
  }
}
      

Response parameters

Name

Type

Description

id

String

The object id of the user.

emailAddress

String

The email address of the user.

password

String

The password of the user.

defaultOrgId

String

The object id of the default org the user is associated to.

firstName

String

The first name of the user.

lastName

String

The last name of the user.

company

String

The name of the company the user belongs to.

title

String

The title the user holds within the company.

officePhone

String

The office phone number of the user.

mobilePhone

String

The mobile phone number of the user.

isSuperAdmin

Boolean

If the user has super admin permission.

isSuperOps

Boolean

If the the user has super ops permission.

support

Boolean

Whether the user has access to the support system.

data

Object

Opaque data store object.

lastLoginOn

Timestamp

The date and time of the user's last login.

createdBy

String

The email address of the user who created the user.

createdOn

Timestamp

The date and time that the user was created.

updatedBy

String

The email address of the user who last updated the user.

updatedOn

Timestamp

The date and time that the user was updated.