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

# List all users

`GET /users/`

## Request

- Base URL: `https://data.public.lu/api/1`
- URL: `https://data.public.lu/api/1/users/`
- Auth: none declared

## Query parameters

- `q` string
- `sort` 'last_name' | 'first_name' | 'datasets' | 'reuses' | 'followers' | 'views' | 'created' | '-last_name' | '-first_name' | '-datasets' | '-reuses' | '-followers' | '-views' | '-created'
- `page` integer
- `page_size` integer

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- UserPage
  - `data` User[]: The page data
    - `about` string, markdown: The user self description
    - `active` boolean
    - `avatar` string: The user avatar URL
    - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
    - `email` object: The user email
    - `first_name` string, required: The user first name
    - `id` string, required: The user identifier
    - `last_name` string, required: The user last name
    - `metrics` object: The user metrics
    - `organizations` OrganizationReference[]: The organization the user belongs to
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `acronym` string: The organization acronym
      - `badges` Badge[]: The organization badges
        - `kind` string, required: Kind of badge (certified, etc), specific to each model
      - `logo` string: The organization logo URL
      - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version.
      - `name` string: The organization name
      - `page` string: The organization web page URL
      - `slug` string, required: The organization string used as permalink
      - `uri` string: The organization API URI
    - `page` string: The user profile page URL
    - `roles` string[]: Site wide user roles
    - `since` string, date-time, required: The registeration date
    - `slug` string, required: The user permalink string
    - `uri` string, required: The user API URI
    - `website` string: The user website
  - `next_page` string: The next page URL if exists
  - `page` integer, required: The current page
  - `page_size` integer, required: The page size used for pagination
  - `previous_page` string: The previous page URL if exists
  - `total` integer, required: The total paginated items

---

[API](https://skmtc.dev/public/apis/udata-api.md) - [All operations](https://skmtc.dev/public/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/public/apis/udata-api/revisions/3f583ca74f7e?raw)