---
title: "Suggest users by name, email or slug"
method: GET
path: "/users/suggest/"
tags: ["users"]
---

# Suggest users by name, email or slug

`GET /users/suggest/`

## Request

- Base URL: `https://dados.gov.pt/api/1`
- URL: `https://dados.gov.pt/api/1/users/suggest/`
- Auth: none declared

Empty query lists recent users.

## Query parameters

- `q` string
- `size` string

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- UserSuggestion[]
  - `avatar_url` string: The user avatar URL
  - `email` object: The user email (only the domain for non-admin user)
  - `first_name` string: The user first name
  - `id` string: The user identifier
  - `last_name` string: The user last name
  - `slug` string: The user permalink string

## Changes

- **2026-09-11** `1175d034be00`: 1 info
  - the `query` request parameter `q` became optional

[Operation history](https://skmtc.dev/dados/apis/udata-api/changes/users/suggest/get.md)

---

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