> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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
```json theme={"dark"}
{
"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](https://library.blinkops.com/workflows/list-system-users-with-jumpcloud-and-send-results-via-email)
Preview this Workflow on desktop