Authorization - Get ProMark users

API Url

Get a specific username from ProMark

GET
http://localhost:16010/ProMarkREST/web/Auth/users/{username}

Permissions: sysop

Path parameters

FieldTypeDescription
usernameoptionalString

Who to query in ProMark.

Query parameters

FieldTypeDescription
filteroptionalString

Query expression used for filtering the records. Example: filter=username eq 'John' or firstName begins 'John'.

skipoptionalNumber

How many records to skip.

sortByoptionalString

Query expression used to sort the resulted records. Example: sortBy=username.

takeoptionalNumber

How many records to load.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    usersObject[]
      disabledBoolean

TRUE if the user is disabled. Will not allow authentication.

      firstNameString

First name of the user.

      idNumber

Unique identifier.

      isAdministratorBoolean

TRUE if the user account has administrator privileges.

      lastNameString

Last name of the user.

      lockedBoolean

TRUE if the user is active but locked out. Will not allow authentication.

      rolesoptionalNumber[]

List of ProMark roles the user holds. 1=Employee, 2=User.

      usernameString

Login username used for authenticating into ProMark.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"users": [
{
"id": 1000,
"username": "john@domain.com",
"firstName": "John",
"lastName": "Doe",
"roles": [
1,
2
],
"disabled": false,
"locked": false,
"isAdministrator": true
}
]
}
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.