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

# GET /core/users/

`GET /core/users/`

User Viewset

## Query parameters

- `attributes` string
- `date_joined` string, date-time
- `date_joined__gt` string, date-time
- `date_joined__lt` string, date-time
- `email` string
- `groups_by_name` string[]
- `groups_by_pk` string[]
- `include_groups` boolean
- `include_roles` boolean
- `is_active` boolean
- `is_superuser` boolean
- `last_login` string, date-time
- `last_login__gt` string, date-time
- `last_login__isnull` boolean
- `last_login__lt` string, date-time
- `last_updated` string, date-time
- `last_updated__gt` string, date-time
- `last_updated__lt` string, date-time
- `name` string
- `ordering` string
- `page` integer
- `page_size` integer
- `path` string
- `path_startswith` string
- `roles_by_name` string[]
- `roles_by_pk` string[]
- `search` string
- `type` UserTypeEnum[]
- `username` string
- `uuid` string, uuid

## Response `200`

- PaginatedUserList
  - `pagination` Pagination, required
    - `next` number, required
    - `previous` number, required
    - `count` number, required
    - `current` number, required
    - `total_pages` number, required
    - `start_index` number, required
    - `end_index` number, required
  - `results` User[], required
    - `pk` integer, required
    - `username` string, required
    - `name` string, required — User's display name.
    - `is_active` boolean — Designates whether this user should be treated as active. Unselect this instead of deleting accounts.
    - `last_login` string, date-time, nullable
    - `date_joined` string, date-time, required
    - `is_superuser` boolean, required
    - `groups` string[]
    - `groups_obj` PartialGroup[], nullable, required
      - `pk` string, uuid, required
      - `num_pk` integer, required — Get a numerical, int32 ID for the group
      - `name` string, required
      - `is_superuser` boolean — Users added to this group will be superusers.
      - `attributes` object
    - `roles` string[]
    - `roles_obj` Role[], nullable, required
      - `pk` string, uuid, required
      - `name` string, required
    - `email` string, email
    - `avatar` string, required — User's avatar, either a http/https URL or a data URI
    - `attributes` object
    - `uid` string, required
    - `path` string
    - `type` 'internal' | 'external' | 'service_account' | 'internal_service_account'
    - `uuid` string, uuid, required
    - `password_change_date` string, date-time, required
    - `last_updated` string, date-time, required
  - `autocomplete` Autocomplete, required

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)