Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page Properties
hiddentrue
idDONE

Product Version
Report Note
Assignee

Resources & Remarks

Modification History

NameDateProduct VersionAction
Antje19 MAY 20212021 SummerPage created.



Note

Deprecated as of version 2023 Spring. Please use the idm-controller endpoints instead.


As of Version

product version 2021 Summer | component version 

Request MethodGET
Response FormatJSON
Description


Excerpt

Retrieves a list of all users. The result list can be filtered by applying conditions that have to be matched.


The conditions are specified via the following optional query parameters:

ParameterTypeDescription
excludeMebooleanIf true, the currently logged-in user is excluded from the result list.
pageinteger($int32)Result page you want to retrieve (0…N). Default is 0 which means the first page.
searchstringRetrieve only users for which the specified string is contained in user name, first name, last name or e-mail.
sizeinteger($int32)Limit the number of users per page
sortstringSorting of results either ascending (asc) or descending (desc). Default sort order is ascending.

Response HTTP status codes:

HTTP Status CodeMeaning
200 OKSuccessful.
401 UnauthorizedNot successful.


Request Example

https://<host>/api-web/api/users/users

no request body

Response Example

200 OK

Code Block
languageyml
[
  {
    "accountNonExpired": true,
    "accountNonLocked": true,
    "authorities": [
      "string"
    ],
    "credentialsNonExpired": true,
    "domain": "string",
    "email": "string",
    "enabled": true,
    "firstname": "string",
    "foreignid": "string",
    "id": "string",
    "lastname": "string",
    "substituteOf": [
      "string"
    ],
    "tenant": "string",
    "title": "string",
    "type": "string",
    "username": "string"
  }
]




Page Properties
hiddentrue
idDONE

Product Version
Report Note
Assignee

Resources & Remarks

Modification History

NameDateProduct VersionAction
Antje19 MAY 20212021 SummerPage created.


...

As of Version

product version 2021 Summer | component version 

Request MethodGET
Response FormatJSON
Description


Excerpt

Retrieves a list of all users. The result list can be filtered by applying conditions that have to be matched.


The conditions are specified via the following optional query parameters:

ParameterTypeDescription
excludeMebooleanIf true, the currently logged-in user is excluded from the result list.
pageinteger($int32)Result page you want to retrieve (0…N). Default is 0 which means the first page.
searchstringRetrieve only users for which the specified string is contained in user name, first name, last name or e-mail.
sizeinteger($int32)Limit the number of users per page
sortstringSorting of results either ascending (asc) or descending (desc). Default sort order is ascending.

Response HTTP status codes:

HTTP Status CodeMeaning
200 OKSuccessful.
401 UnauthorizedNot successful.


Request Example

https://<host>/api-web/api/users/users

no request body

Response Example

200 OK

Code Block
languageyml
[
  {
    "accountNonExpired": true,
    "accountNonLocked": true,
    "authorities": [
      "string"
    ],
    "credentialsNonExpired": true,
    "domain": "string",
    "email": "string",
    "enabled": true,
    "firstname": "string",
    "foreignid": "string",
    "id": "string",
    "lastname": "string",
    "substituteOf": [
      "string"
    ],
    "tenant": "string",
    "title": "string",
    "type": "string",
    "username": "string"
  }
]


...