---
title: "Retorna uma empresa específica através do ID."
method: GET
path: "/v1/merchants/{id}"
tags: ["merchants"]
---

# Retorna uma empresa específica através do ID.

`GET /v1/merchants/{id}`

## 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/merchants/{id}`
- Auth: HTTP basic

## Path parameters

- `id` integer, required

## Response `200`

Ok. Empresa encontrada.

- 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.
- `404`: Empresa não encontrada.
- `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)