List Users

This endpoint fetches user data based on filters like name, status, archive state, usage metrics, reporting manager, and cost center. Supports pagination and sorting.

Supported Filters Table:

FieldTypeDescription / Allowed Values
user_idstringUser ID
user_namestringUser Name
user_emailstringUser Email
user_statusenumUser Status (active, inactive, suspended, unknown)
user_account_typeenumAccount Type (group, employee, service, external)
user_department_idstringDepartment ID
user_designationstringJob Title
user_owner_idstringOwner
user_alternate_emailsstringAlternate Emails
source_arrayobjectSources
primary_sourceobjectPrimary Source
user_joining_daterangeJoining Date (range)
user_created_atrangeCreated On (range)
user_archivebooleanArchive Status
user_usagerangeUsage (Score) (range)
optimization_inclusionenumOptimization Inclusion (Excluded for all Optimizations, Excluded for Unused, Excluded for Undeprovisioned, Included for all Optimizations)
user_reporting_manager_idstringReporting Manager ID (the id of the reporting manager)
user_cost_center_idstringCost Center ID
custom_fieldsobjectCustom Fields (see example below)

Source Array Filter Format: For filtering by source information (integrations, agents, etc.), use the following format:

Manual Source Filter:

{
  "field_id": "source_array",
  "field_values": [
    {
      "key": "keyword",
      "value": ["manual"],
      "value_type": "string"
    }
  ]
}

Integration Source Filter:

{
  "field_id": "source_array",
  "negative": false,
  "field_values": [
    {
      "key": "org_integration_id",
      "value_type": "objectId",
      "value": ["681047a5b5c755b83e0ff982"]
    }
  ]
}

Available Source Keys:

  • keyword - Source keyword (e.g., "manual", "okta", "slack")
  • org_integration_id - Organization integration ID
  • global_agent_id - Global agent ID

Date Range Filter Format: For filtering by date/time fields, use the field_order parameter to specify comparison operators:

Date Range Filter (Between two dates):

{
  "field_id": "user_joining_date",
  "field_values": ["2025-11-12", "2025-11-13"],
  "field_order": ["gte", "lte"]
}

Single Date Comparison:

{
  "field_id": "user_created_at",
  "field_values": ["2025-11-12"],
  "field_order": ["gte"]
}

Available Field Order Operators:

  • gte - Greater than or equal to
  • lte - Less than or equal to
  • eq - Equal to
  • ne - Not equal to
  • lt - Less than
  • gt - Greater than

Example Custom Field Filter:

{
  "field_id": "custom_fields",
  "field_values": {
    "custom_field_id": "679b613f315ee0a11cb67bd1",
    "custom_field_values": ["India"]
  }
}

Use these as field_id values inside the filter_by array in the request body to filter results.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The page parameter determines which set of data is returned in a paginated response. Start from page 0 to retrieve the first set of results.

string

The page_size parameter specifies the number of results per page. The default is 30. Maximum is 100.

string

The search_query parameter allows you to search for users by their name or email. It supports partial matches.

Body Params
filter_by
array of objects

Filters to apply on users data

filter_by
sort_by
array of objects

Sort options like { user_name: 1 } for ascending or { user_name: -1 } for descending

sort_by
Headers
string
required

Your Zluri API key for authentication

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json