---
title: "List all users"
method: GET
path: "/users"
tags: ["Users"]
---

# List all users

`GET /users`

Returns all users, optionally filtered by query parameters.

## Query parameters

- `email` string

## Response `200`

List of users

- User[]
  - `_id` string — MongoDB ObjectId
  - `name` object
    - `firstName` string
    - `lastName` string
  - `email` string, email
  - `accessLevel` 'user' | 'admin' | 'superadmin'
  - `role` string
  - `createdDate` string, date-time
  - `currentRole` string
  - `desiredRole` string
  - `newMember` boolean
  - `currentJobTitle` string
  - `desiredJobTitle` string
  - `skillsToMatch` string[]
  - `firstAttended` string
  - `attendanceReason` string
  - `projects` string[]
  - `githubHandle` string
  - `phone` string
  - `textingOk` boolean
  - `slackName` string
  - `isHflaGithubMember` boolean
  - `githubPublic2FA` boolean
  - `availability` string
  - `managedProjects` string[]
  - `isActive` boolean

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/hackforla/apis/vrms-api.md) · [All operations](https://skmtc.dev/hackforla/apis/vrms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hackforla/vrms-api/revisions/092c34cc0e58/schema)