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

# Find users

`GET /users`

# Find users by query filters.
>* Retrieve users based on query parameters.
>>* Recuperar usuários com base em parâmetros de consulta.

## Query parameters

- `name` string
- `email` string
- `role` string
- `tax_number` string
- `phone` string
- `blocked_at` boolean
- `created_greater_or_equal_than` string
- `created_less_or_equal_than` string
- `company_id` integer
- `limit` integer
- `page` integer

## Response `200`

List of users matching the filters | Lista de usuários que correspondem aos filtros

- DomainUserFindResponse
  - `limit` integer
  - `page` integer
  - `rows` DomainUserResponse[]
    - `blocked_at` string
    - `company_id` integer
    - `created_at` string
    - `email` string
    - `id` integer
    - `language` string
    - `name` string
    - `phone` string
    - `role` string
    - `tax_number` string
    - `timezone` string
    - `updated_at` string
  - `sort` string
  - `total_pages` integer
  - `total_rows` integer

## Other responses

- `400` — Validation error in the query parameters | Erro de validação nos parâmetros de consulta
- `401` — Unauthorized | Não autorizado
- `403` — Forbidden | Proibido
- `500` — General errors, internal server error, etc... | Erros gerais, erro interno do servidor, etc...

---

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