GuidesAPI Reference
Log In
API Reference
These docs are for v2025.2.0. Click to read the latest docs for v2026.2.0.

List users

Returns a paginated list of users.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
uri
length ≥ 1

This URL will be invoked when results are ready for retrieval. The payload will contain the location of the results file. Use the Check Deferred Execution Status API to poll for status, or include a value for callback_url to be notified when results are ready.

date-time | null

Filter upon the create date/time using ISO8601 format. Assumption is UTC unless TZ offset is specified.

integer
deprecated

Filter upon User ID. (Deprecated, use user_id instead.)

boolean

If False, this user is treated as inactive.

boolean

Set to true to request asynchronous processing, which is required for larger data requests.

integer

Maximum number of results per page. The default is 25.

string

Fields to order upon. Valid fields include: user_id, id, create_datetime, update_datetime

integer

Page of results to retrieve

string

Term(s) to search for. The following fields will be searched: username, display_name, first_name, last_name, employee_number, email, create_datetime, update_datetime

date-time | null

Filter upon the update date/time using ISO8601 format. Assumption is UTC unless TZ offset is specified.

integer

The unique system assigned value that identifies this record.

string
length ≥ 1

Required. 30 characters or fewer. Letters, digits and ./-/_ only.

Headers
integer
required

The id of the active store to be used for this API invocation

Responses

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