---
title: "GET /v1/users"
method: GET
path: "/v1/users"
tags: ["UserReaderService"]
---

# GET /v1/users

`GET /v1/users`

## Query parameters

- `names` string[]
- `sortOrder.by` 'ORDER_BY_NONE' | 'ORDER_BY_NAME' | 'ORDER_BY_CREATE_TIME'
- `sortOrder.descending` boolean

## Response `200`

A successful response.

- V1ListUsersResponse
  - `users` V1User[]
    - `id` string
    - `name` string
    - `createTime` string, date-time

## Other responses

- `default` — An unexpected error response

## Changes

> 2 revisions in range; 1 could not be searched.

- **2020-05-19** `1f2cb4266ef3` — 2 warning, 2 info
  - deleted the `query` request parameter `sortOrder.by`
  - deleted the `query` request parameter `sortOrder.descending`
  - added the new optional `query` request parameter `sort_order.by`
  - added the new optional `query` request parameter `sort_order.descending`

[Change history](https://skmtc.dev/uw-labs/apis/example-user-api/changes/v1/users/get.md)

---

[API](https://skmtc.dev/uw-labs/apis/example-user-api.md) · [All operations](https://skmtc.dev/uw-labs/apis/example-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uw-labs/example-user-api/revisions/189ccb57a528/schema)