ZITADEL Docs
APIsCore ResourcesV1Organization Objects

ListUsers

Search Users

Deprecated: use user service v2 ListUsers instead.

Search for users within an organization. By default, we will return users of your organization. Make sure to include a limit and sorting for pagination.

POST
/users/_search

Request Body

application/json

query?

list limitations and ordering

sortingColumn?string

the field the result is sorted

Value in"USER_FIELD_NAME_UNSPECIFIED" | "USER_FIELD_NAME_USER_NAME" | "USER_FIELD_NAME_FIRST_NAME" | "USER_FIELD_NAME_LAST_NAME" | "USER_FIELD_NAME_NICK_NAME" | "USER_FIELD_NAME_DISPLAY_NAME" | "USER_FIELD_NAME_EMAIL" | "USER_FIELD_NAME_STATE" | "USER_FIELD_NAME_TYPE" | "USER_FIELD_NAME_CREATION_DATE"
queries?

criteria the client is looking for

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/users/_search" \  -H "Content-Type: application/json" \  -d '{}'
{
  "details": {
    "totalResult": 0,
    "processedSequence": 0,
    "viewTimestamp": "1s"
  },
  "sortingColumn": "USER_FIELD_NAME_UNSPECIFIED",
  "result": [
    {
      "id": "string",
      "details": {
        "sequence": 0,
        "creationDate": "1s",
        "changeDate": "1s",
        "resourceOwner": "string"
      },
      "state": "USER_STATE_UNSPECIFIED",
      "userName": "string",
      "loginNames": [
        "string"
      ],
      "preferredLoginName": "string",
      "human": {
        "profile": {
          "firstName": "string",
          "lastName": "string",
          "nickName": "string",
          "displayName": "string",
          "preferredLanguage": "string",
          "gender": "GENDER_UNSPECIFIED",
          "avatarUrl": "string"
        },
        "email": {
          "email": "string",
          "isEmailVerified": true
        },
        "phone": {
          "phone": "string",
          "isPhoneVerified": true
        },
        "passwordChanged": "1s"
      }
    }
  ]
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?