> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftsheet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Users

> Retrieve a paginated list of users for your company.

This is primarily useful for syncing user directories with third-party HR, payroll, or SSO tools.

### Query Parameters

<ParamField query="role" type="string">
  Filter users by their role (e.g., `SUPER_ADMIN`, `COMPANY_ADMIN`, `MANAGER`, `EMPLOYEE`).
</ParamField>

<ParamField query="employmentType" type="string">
  Filter users by employment type (e.g., `FULL_TIME`, `PART_TIME`, `CASUAL`, `CONTRACTOR`).
</ParamField>

<ParamField query="isActive" type="boolean">
  Filter active vs inactive users. Defaults to `true`.
</ParamField>

### Response

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": "usr_123...",
        "email": "jane.doe@example.com",
        "firstName": "Jane",
        "lastName": "Doe",
        "role": "EMPLOYEE",
        "employmentType": "FULL_TIME",
        "position": "Software Engineer",
        "isActive": true,
        "assignedManagerId": "usr_456...",
        "createdAt": "2026-05-01T00:00:00.000Z",
        "updatedAt": "2026-05-18T00:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>