---
title: "Search for users"
method: GET
path: "/users/search"
tags: ["Users"]
---

# Search for users

`GET /users/search`

Requests without authentication will return an empty email field for anti-spam purposes.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Success

- object
  - `data` User[]
    - `id` integer
    - `username` string
    - `login` string — Alias of username for GitHub API compatibility
    - `full_name` string
    - `email` string, email
    - `avatar_url` string
  - `ok` boolean

---

[API](https://skmtc.net/gogs/apis/gogs-api.md) · [All operations](https://skmtc.net/gogs/apis/gogs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gogs/gogs-api/revisions/87e2da32266c/schema)