Skip to main content

Query Users (v2.0)



Query all the users.



Details to query the users.

    aggregate Aggregate

    The aggregate number of users that match the query parameters.

    data AggregateData[]

    The details of the aggregate data.

  • Array [
  • value number

    Value of the aggregate data.

    view object

    View the aggregate date.

  • ]
  • field string

    The field value.

    name string

    The name of the query response.

    operator string

    Possible values: [max, count, min, avg, sum]

    The operator values.

    statistic string

    The aggregate statistics.

    unit string

    The unit.

    dest_page int32

    The destination page.

    getDeleted boolean

    The number users deleted for a time frame.

    group_by string[]

    Group the users for the query.

    id string

    List the users by ID.

    last_query_ts int64

    Return the ID of a specified query in the current session.

    limit int32

    The query limit.

    next_query object

    The limit.

    query_params object

    Query using query parameters.

    retrieved_fields string[]

    Retrieve information from a field.

    retrieved_fields_mask boolean

    List the fields to query.

    sort_params object

    Specify the order in which you want the search criteria to display.

    total_count int64

    The total number of query parameters.


Successful Operation

    count int32

    The actual count.

    deleted_count int64

    The deleted number.

    deleted_ids string[]

    The deleted IDs.


    Description of the query. Max size = 256.

    id string

    The ID.

    next_query object

    Details of the next query.

    total_count int64

    Total number.

    items DirectoryUserQueryFilter[]
  • Array [
  • description

    The description of the user. Max size = 256.

    id string

    The user ID.

    name stringrequired

    The user's name.

    stale boolean


    tags string[]

    A information field that can be added to identify the user. Maximum 10 unique tags of length 1024 each are allowed.

    user_group_ids string[]

    The user group IDs to which the user belongs.

  • ]