---
title: "Retorna uma lista de usuários associados à empresa atual."
method: GET
path: "/v1/merchant_users"
tags: ["merchant_users"]
---

# Retorna uma lista de usuários associados à empresa atual.

`GET /v1/merchant_users`

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/merchant_users`
- Auth: HTTP basic

Utilize este método para listar os Usuários de um determinado merchant. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150).

#### Atributos para busca
<code>id</code>, <code>email</code> e <code>status</code>.

## Query parameters

- `page` integer
- `per_page` integer
- `query` string
- `sort_by` 'id' | 'email' | 'status'
- `sort_order` 'asc' | 'desc'

## Response `200`

Consulta realizada com sucesso.

- MerchantUser[]
  - `id` integer, required: Id
  - `status` string, required: Status
  - `last_sign_in_at` string, required: Último login
  - `user` Summary, required
    - `id` integer, required: Id
    - `name` string, required: Nome
    - `email` string, required: E-mail
    - `status` string, required: Status
    - `created_at` string, required: Created at
  - `role` Full, required: Retorna o usuário atual.
    - `id` integer, required: Id
    - `name` string, required: Translated name
    - `base_role` string, required: Perfil básico

## Other responses

- `400`: Erro de sintaxe JSON no corpo do request.
- `422`: Parâmetros inválidos. Verificar erro na resposta.

---

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