Consultar Lojista

Retorna os dados de um comerciante específico.

Endpoint

GET/v1/merchants/{merchantId}

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
merchantId	string	✓	ID único do lojista

Request

curl -X GET https://yby-dev.positivolabs.com.br/v1/merchants/{merchantId} \
  -H "Authorization: Bearer <accessToken>"

Resposta

{
  "id": "d6uo5nc42nrc73gv867g",
  "createdAt": "2026-03-20T10:00:00Z",
  "updatedAt": "2026-03-20T10:00:00Z",
  "type": "merchant",
  "dbaName": "Coffee Shop LTDA",
  "corporateName": "Coffee Shop Comércio LTDA",
  "taxId": "12345678000190",
  "parentId": "d59gpddc93gc73jvje0g",
  "merchantCategoryCode": "5347",
  "economicActivityCode": "4712100",
  "address": {
    "id": "d6uo5nc42nrc73gv8680",
    "postalCode": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua das Flores",
    "number": "123",
    "complement": "Sala 1",
    "country": "BR"
  },
  "contact": {
    "id": "d6uo5nc42nrc73gv8681",
    "site": "http://coffeeshop.com",
    "email": "contact@coffeeshop.com",
    "phone": "+5511999999999"
  },
  "bankAccounts": [
    {
      "id": "d6uo5nc42nrc73gv8682",
      "accountType": "checking",
      "routingNumber": "0001",
      "accountNumber": "12345678-9"
    }
  ],
  "contactPerson": [
    {
      "id": "d6uo5nc42nrc73gv8683",
      "name": "João Silva",
      "taxId": "12345678900",
      "email": "joao@coffeeshop.com",
      "phone": "+5511988888888",
      "position": "Gerente"
    }
  ]
}