---
title: "Filter users by key/value"
method: GET
path: "/users/filter"
tags: ["Users"]
---

# Filter users by key/value

`GET /users/filter`

## Request

- Base URL: `https://dummyjson.com`
- URL: `https://dummyjson.com/users/filter`
- Auth: none required

## Query parameters

- `key` string, required
- `value` string, required
- `limit` integer
- `skip` integer
- `select` string
- `sortBy` string
- `order` 'asc' | 'desc'
- `delay` integer

## Response `200`

Filtered users

- UserList
  - `users` User[]
    - `id` integer
    - `firstName` string
    - `lastName` string
    - `maidenName` string
    - `age` integer
    - `gender` string
    - `email` string
    - `phone` string
    - `username` string
    - `password` string
    - `birthDate` string
    - `image` string
    - `bloodGroup` string
    - `height` number
    - `weight` number
    - `eyeColor` string
    - `hair` object
      - `color` string
      - `type` string
    - `ip` string
    - `address` object
      - `address` string
      - `city` string
      - `state` string
      - `stateCode` string
      - `postalCode` string
      - `coordinates` object
        - `lat` number
        - `lng` number
      - `country` string
    - `macAddress` string
    - `university` string
    - `bank` object
      - `cardExpire` string
      - `cardNumber` string
      - `cardType` string
      - `currency` string
      - `iban` string
    - `company` object
      - `department` string
      - `name` string
      - `title` string
      - `address` object
        - `address` string
        - `city` string
        - `state` string
        - `stateCode` string
        - `postalCode` string
        - `coordinates` object
          - `lat` number
          - `lng` number
        - `country` string
    - `ein` string
    - `ssn` string
    - `userAgent` string
    - `crypto` object
      - `coin` string
      - `wallet` string
      - `network` string
    - `role` string
  - `total` integer
  - `skip` integer
  - `limit` integer

---

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