---
title: "List Users"
method: GET
path: "/api/v1/auth-management/users"
tags: ["userManagement"]
---

# List Users

`GET /api/v1/auth-management/users`

List users in the organization.

This endpoint retrieves a paginated list of users in the organization.
The response can be filtered by a search query and optionally include user roles.

## Query parameters

- `query` string, nullable
- `user_ids` string[], nullable
- `offset` integer
- `limit` integer
- `include_roles` boolean

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of users in the organization

- UsersListResponse — Response model for listing users with pagination. This model contains a paginated list of users with partial information and metadata about the pagination. It is used for endpoints that return multiple users with their basic information.
  - `users` PartialUserResponse[], required — List of users with partial information
    - `user_id` string, required — Unique identifier for the user
    - `name` string, required — Display name of the user
    - `email` string, nullable — Email address of the user
    - `picture` string, nullable — URL to the user's profile picture
    - `created_at` string, date-time, required — Timestamp when the user was created
    - `last_login` string, date-time, nullable — Timestamp of the user's last login
    - `roles` Role[], nullable — Optional list of roles assigned to the user
      - `role_id` string, required — Name of the role (e.g., 'admin', 'editor', 'viewer')
      - `resource` string, nullable — Optional resource type the role applies to (e.g., 'dataset')
      - `resource_instance` string, nullable — Optional resource instance ID the role applies to
  - `meta` PagedMeta, required — Metadata for paginated responses
    - `page` PagedPageDetails, required — Pagination metadata
      - `current_page` integer, required — Current page number (1-indexed)
      - `last_page` integer, nullable — Last page number (if total is known)
      - `limit` integer, required — Number of items per page
      - `offset` integer, required — Offset of the first item in the current page
      - `total` integer, nullable — Total number of items across all pages
    - `links` PagedLinks, required — Metadata for retrieving paginated data
      - `prev` string, nullable — URL for the previous page
      - `next` string, nullable — URL for the next page
      - `first` string, nullable — URL for the first page
      - `last` string, nullable — URL for the last page
    - `sort` SortItem1[], required — Sort order for the response
      - `direction` 'asc' | 'desc', required — Possible sort orders
      - `field` string, required — Field name to sort by

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)