---
title: "Detalhe do merchant"
description: "GET /v1/store/merchants/:merchantId — perfil do cardápio (identidade, contato, endereço e mídia)."
method: "GET"
path: "/v1/store/merchants/{merchantId}"
url: "https://developer.beefood.com.br/docs/loja/merchant"
group: "Restaurante"
scope: "store:read"
lang: "pt"
---
# Detalhe do merchant

`GET /v1/store/merchants/{merchantId}`

- Produção: `https://api.beefood.app/v1/store/merchants/{merchantId}`
- Sandbox: `https://api-sandbox.beefood.app/v1/store/merchants/{merchantId}`

Retorna o perfil de uma filial ativa, com ou sem cardápio de delivery.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `store:read`. Limite: 15 requisições por minuto.


## Parâmetros de path

- `merchantId` *integer* **obrigatório** — ID do cardápio. Exemplo: `1`.





## Exemplos de requisição

### cURL

```bash
curl -X GET "https://api.beefood.app/v1/store/merchants/{merchantId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Exemplos de resposta

### 200 OK

```json
{
  "storeId": 38311,
  "merchantId": 39202,
  "tradeName": "Restaurante Exemplo",
  "legalName": "Restaurante Exemplo",
  "cnpj": "12345678000199",
  "accessLink": "https://menu.exemplo.com.br/restaurante-exemplo",
  "email": "contato@exemplo.com",
  "whatsapp": "11999990000",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "neighborhood": "Centro",
    "city": "Sorocaba",
    "state": "SP",
    "zipCode": "18040370",
    "latitude": -23.5015,
    "longitude": -47.4526
  },
  "media": {
    "logoUrl": "https://cdn.exemplo.com.br/restaurante-exemplo/logoUrl.webp",
    "logoUrl180": "https://cdn.exemplo.com.br/restaurante-exemplo/logoUrl180.webp",
    "logoUrl360": "https://cdn.exemplo.com.br/restaurante-exemplo/logoUrl360.webp",
    "coverUrl": "https://cdn.exemplo.com.br/restaurante-exemplo/coverUrl.webp",
    "coverUrl828": "https://cdn.exemplo.com.br/restaurante-exemplo/coverUrl828.webp",
    "coverUrl1920": "https://cdn.exemplo.com.br/restaurante-exemplo/coverUrl1920.webp"
  },
  "primaryColor": "#b91c1c",
  "actionColor": "#ffc107",
  "deliveryCategoryId": 2,
  "main": true
}
```


## Campos da resposta

- `storeId` *number* — ID do restaurante.

- `merchantId` *number* — ID do cardápio.

- `tradeName` *string* — Nome fantasia.

- `legalName` *string* — Razão social.

- `cnpj` *string* — CNPJ do cardápio.

- `description` *string* — Descrição pública do restaurante.

- `accessLink` *string* — Link de acesso ao cardápio/restaurante.

- `email` *string* — E-mail de contato.

- `phone` *string* — Telefone de contato.

- `whatsapp` *string* — WhatsApp de contato.

- `address.street` *string* — Rua.

- `address.number` *string* — Número.

- `address.neighborhood` *string* — Bairro.

- `address.city` *string* — Cidade.

- `address.state` *string* — UF.

- `address.zipCode` *string* — CEP.

- `address.latitude` *number* — Latitude.

- `address.longitude` *number* — Longitude.

- `media.logoUrl` *string* — Logo.

- `media.logoUrl180` *string* — Logo 180px.

- `media.logoUrl360` *string* — Logo 360px.

- `media.coverUrl` *string* — Capa.

- `media.coverUrl828` *string* — Capa 828px.

- `media.coverUrl1920` *string* — Capa 1920px.

- `primaryColor` *string* — Cor principal da identidade.

- `actionColor` *string* — Cor de destaque/ações.

- `deliveryCategoryId` *number* — Categoria do delivery.

- `main` *boolean* — Indica se é o cardápio principal.



## Erros

| Status | Mensagem |
| --- | --- |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the store:read scope |
| 404 | Merchant ID 99 not found |