---
title: "Retorna uma lista de empresas."
method: GET
path: "/v1/merchants"
tags: ["merchants"]
---

# Retorna uma lista de empresas.

`GET /v1/merchants`

## Query parameters

- `page` integer
- `per_page` integer
- `query` string
- `sort_by` 'id' | 'name' | 'status' | 'code' | 'email' | 'registry_code' | 'created_at' | 'updated_at'
- `sort_order` 'asc' | 'desc'

## Response `200`

Consulta realizada com sucesso.

- Merchant[]
  - `id` integer, required — ID da empresa
  - `name` string, required — Nome da empresa
  - `company_name` string, required — Razão social
  - `registry_code` string, required — CNPJ da empresa
  - `email` string, required — Email de contato da empresa
  - `status` 'active' | 'inactive' | 'trial', required — Status da empresa

## Other responses

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

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)