ADM-OPERATOR-USER-550 - List Operator Users

Overview
Returns a paginated list of operator users for administration purposes.

User scoping
Admin endpoint. Only operator users can call this endpoint (dj-client: OPERATOR).

Store scoping
The request context store can be provided via dj-store and dj-store-view headers. Store restrictions are defined per operator user through stores and do not filter the list by default.

Visibility
Results are filtered by platform permissions of the authenticated operator user. Users outside the caller visibility scope are not returned.

Scope of data returned
Each item includes identity fields, groups, status, and store restriction (stores). It does not include sensitive credentials (passwords, secrets).

Filters
No functional filters are supported on this endpoint (pagination and sorting only). Unknown or invalid filtering parameters are ignored.

Sorting
Sorting criteria follow sort=property,(asc|desc). Multiple sort criteria are supported. Malformed sort entries are silently ignored and the request still succeeds.

Pagination
Uses standard page (zero-based) and size pagination parameters.

Errors
Returns authentication errors (401), authorization errors (403), and unexpected server errors (500).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 0
Defaults to 0

Zero-based page index (0..N)

integer
≥ 1
Defaults to 20

The size of the page to be returned

sort
array of strings

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

sort
string

Full-text search across operator user properties. Searches: email, firstName, lastName.

ids
array of strings

Filter by Djust internal ID(s). Multi-value (OR).

ids
externalIds
array of strings

Filter by external ID(s). Multi-value (OR).

externalIds
string
enum

Filter by operator user status.

Allowed:
groups
array of strings

Filter by operator user group(s) / profile(s). Multi-value (OR).

groups
storeIds
array of strings

Filter by store(s) the operator user is attached to. Multi-value (OR).

storeIds
Headers
string
enum
required

Specifies the client type making the request.

  • OPERATOR: Platform operator user.

  • ACCOUNT: Customer account user.

  • SUPPLIER: Supplier managing orders.

Allowed:
string
required

API key required for authentication. Must be valid and linked to the requesting user.

string

(Optional) Store ID in multi-store environments.

string

(Optional) Store view ID in multi-store environments.

Responses

401

Unauthorized (invalid or missing API key)

403

Forbidden (insufficient permissions)

500

Internal server error

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