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

# GET /users

`GET /users`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/users`
- Auth: none declared

## Query parameters

- `page` integer
- `limit` integer
- `q` string
- `gender` 'any' | 'male' | 'female' | 'nonbinary': Users Search Query Gender.
- `location` string
- `maxAge` integer
- `minAge` integer

## Response `200`

Returns search results for users

- UsersSearch: User Results
  - `data` object[]
    - `url` string: MyAnimeList URL
    - `username` string: MyAnimeList Username
    - `images` UserImages
      - `jpg` object: Available images in JPG
        - `image_url` string, nullable: Image URL JPG
      - `webp` object: Available images in WEBP
        - `image_url` string, nullable: Image URL WEBP
    - `last_online` string: Last Online Date ISO8601
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2022-07-06** `e69825401bbc`: 1 warning, 1 info
  - removed the optional property `allOf[subschema #1]/data/items/` from the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/images` to the response with the `200` status
- **2022-06-07** `7bb85abe8182`: 4 info
  - added the optional property `allOf[subschema #1]/data/items/` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/last_online` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/url` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/username` to the response with the `200` status
- **2022-06-07** `660c331cabd5`: 4 warning
  - removed the optional property `allOf[subschema #1]/data/items/` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/data/items/last_online` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/data/items/url` from the response with the `200` status
  - removed the optional property `allOf[subschema #1]/data/items/username` from the response with the `200` status
- …earlier changes not shown

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

---

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