List System Users

This endpoint returns all systemusers.

Sample Request

curl -X GET https://console.jumpcloud.com/api/systemusers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

Basic Parameters

Parameter	Description
Fields	The space separated fields included in the returned records. If omitted the default list of fields will be returned.
Filter	A filter to apply to the query. See the supported operators below. For more complex searches, see the related /search/<domain> endpoints, e.g. /search/systems. Filter structure: <field>:<operator>:<value>. field = Populate with a valid field from an endpoint response. operator = Supported operators are: - $eq (equals) - $ne (does not equal) - $gt (is greater than) - $gte (is greater than or equal to) - $lt (is less than) - $lte (is less than or equal to) Note: v1 operators differ from v2 operators. Note: For v1 operators, excluding the $ will result in undefined behavior. value = Populate with the value you want to search for. Is case sensitive. Examples - GET /users?filter=username:$eq:testuser - GET /systemusers?filter=password_expiration_date:$lte:2021-10-24 - GET /systemusers?filter=department:$ne:Accounting - GET /systems?filter[0]=firstname:$eq:foo&filter[1]=lastname:$eq:bar - this will AND the filters together. - GET /systems?filter[or][0]=lastname:$eq:foo&filter[or][1]=lastname:$eq:bar - this will OR the filters together.
Search	A nested object containing a searchTerm string or array of strings and a list of fields to search on.
Sort	The space separated fields used to sort the collection. Default sort is ascending, prefix with - to sort descending.

Advanced Parameters

Parameter	Description
Limit	The number of records to return at once.
Organization ID	Organization identifier that can be obtained from console settings.
Skip	The offset into the records to return.

Example Output

{
    "results": [
        {
            "_id": "string",
            "account_locked": true,
            "account_locked_date": "string",
            "activated": true,
            "addresses": [
                {
                    "country": "string",
                    "extendedAddress": "string",
                    "id": "string",
                    "locality": "string",
                    "poBox": "string",
                    "postalCode": "string",
                    "region": "string",
                    "streetAddress": "string",
                    "type": "string"
                }
            ],
            "allow_public_key": true,
            "alternateEmail": "string",
            "attributes": [
                {
                    "name": "string",
                    "value": "string"
                }
            ],
            "badLoginAttempts": 0,
            "company": "string",
            "costCenter": "string",
            "created": "string",
            "creationSource": "string",
            "department": "string",
            "description": "string",
            "disableDeviceMaxLoginAttempts": true,
            "displayname": "string",
            "email": "string",
            "employeeIdentifier": "string",
            "employeeType": "string",
            "enable_managed_uid": true,
            "enable_user_portal_multifactor": true,
            "external_dn": "string",
            "external_password_expiration_date": "string",
            "external_source_type": "string",
            "externally_managed": true,
            "firstname": "string",
            "jobTitle": "string",
            "lastname": "string",
            "ldap_binding_user": true,
            "location": "string",
            "managedAppleId": "string",
            "manager": "string",
            "mfa": {
                "configured": true,
                "exclusion": true,
                "exclusionDays": 1,
                "exclusionUntil": "2019-08-24T14:15:22Z"
            },
            "mfaEnrollment": {
                "overallStatus": "NOT_ENROLLED",
                "pushStatus": "NOT_ENROLLED",
                "totpStatus": "NOT_ENROLLED",
                "webAuthnStatus": "NOT_ENROLLED"
            },
            "middlename": "string",
            "organization": "string",
            "password_expiration_date": "string",
            "password_expired": true,
            "password_never_expires": true,
            "passwordless_sudo": true,
            "phoneNumbers": [
                {
                    "id": "string",
                    "number": "string",
                    "type": "string"
                }
            ],
            "public_key": "string",
            "recoveryEmail": {
                "address": "string",
                "verified": true,
                "verifiedAt": "string"
            },
            "relationships": [
                {
                    "type": "string",
                    "value": "string"
                }
            ],
            "samba_service_user": true,
            "ssh_keys": [
                {
                    "_id": "string",
                    "create_date": "string",
                    "name": "string",
                    "public_key": "string"
                }
            ],
            "state": "STAGED",
            "sudo": true,
            "suspended": true,
            "tags": [
                "string"
            ],
            "totp_enabled": true,
            "unix_guid": 1,
            "unix_uid": 1,
            "username": "string"
        }
    ],
    "totalCount": 0
}

Workflow Library Example

List System Users with Jumpcloud and Send Results Via Email

Preview this Workflow on desktop