---
title: "GET /api/v1.0/users/"
method: GET
path: "/api/v1.0/users/"
tags: ["admin-users-list"]
---

# GET /api/v1.0/users/

`GET /api/v1.0/users/`

List users.
Search users by email, full name or maildomain.
A search query of at least 3 characters is required.

## Query parameters

- `maildomain_pk` string, uuid
- `q` string

## Response `200`

- UserWithoutAbilities[]
  - `id` string, uuid, required — primary key for the record as UUID
  - `email` string, email, nullable, required
  - `full_name` string, nullable, required
  - `custom_attributes` object, required — Get custom attributes for the instance.

---

[API](https://skmtc.net/betagouv/apis/messages-api.md) · [All operations](https://skmtc.net/betagouv/apis/messages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/betagouv/messages-api/versions/5c64242ea839/schema)