---
title: "Get a list of users."
method: GET
path: "/v1/users"
tags: ["userManagement"]
---

# Get a list of users.

`GET /v1/users`

Get a list of all users in the organization. The response is paginated with a default limit of 100 users per page.

## Query parameters

- `limit` integer
- `token` string
- `sortBy` string
- `email` string
- `includeServiceAccounts` boolean

## Response `200`

A paginated list of users in the organization.

- ListUserModelsResponse
  - `data` UserModel[], required — List of users.
    - `firstName` string, required — First name of the user.
    - `lastName` string, required — Last name of the user.
    - `email` string, email, required — Email address of the user.
    - `roleIds` string[], required — List of roleIds associated with the user.
    - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
    - `createdBy` string, required — Identifier of the user who created the resource.
    - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
    - `modifiedBy` string, required — Identifier of the user who last modified the resource.
    - `id` string, required — Unique identifier for the user.
    - `isActive` boolean — True if the user is active.
    - `isLocked` boolean — This has the value `true` if the user's account has been locked. If a user tries to log into their account several times and fails, his or her account will be locked for security reasons.
    - `isMfaEnabled` boolean — True if multi factor authentication is enabled for the user.
    - `lastLoginTimestamp` string, date-time — Timestamp of the last login for the user in UTC. Will be null if the user has never logged in.
  - `next` string — Next continuation token.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/18a824df1e78/schema)