---
title: "Lists users"
method: GET
path: "/users"
tags: ["User"]
---

# Lists users

`GET /users`

## Request

- Base URL: `http://localhost:3001/api`
- URL: `http://localhost:3001/api/users`
- Auth: none declared

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- UserArray
  - `users` User[]
    - `allOf` RoleArray
      - `roles` Role[]
    - `name` string, nullable: Full name of the user if provided by the OAuth provider
    - `email` string, email, required
    - `googleID` string: Unique identifier for the google account of the user
  - `total` integer

## Other responses

- `400`: Malformed request
- `403`: Forbidden
- `422`: Unprocessable entity
- `500`: Internal server error

## Changes

- **2022-05-26** `6edfe4a1f6b0`: 1 breaking
  - the response property `users/items/name` became nullable for the status `200`
- **2022-04-19** `7b73390be316`: 1 info
  - added the media type `application/json` for the response with the status `403`

[Operation history](https://skmtc.dev/globaldothealth/apis/global-health-curator-service-api/changes/users/get.md)

---

[API](https://skmtc.dev/globaldothealth/apis/global-health-curator-service-api.md) - [All operations](https://skmtc.dev/globaldothealth/apis/global-health-curator-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/globaldothealth/apis/global-health-curator-service-api/revisions/5b1151265235?raw)