Skip to main content

​
🏪 Obter Loja por ID

Este endpoint permite consultar uma loja específica da sua conta pelo ID. Ele é ideal para:
  • Carregar detalhes completos de uma loja
  • Buscar dados relacionados (categorias, produtos, cupons e pagamentos)
  • Validar se uma loja existe antes de outras operações

​
🔐 Autenticação

Esta rota exige autenticação via API Key, enviada no header da requisição: 
Authorization: SUA_API_KEY_AQUI

​
📥 Parâmetros de Rota

ParâmetroTipoObrigatórioDescrição
storeIdstring (UUID)SimID da loja que será consultada.

​
📋 Exemplo de Requisição

curl --location "https://api.cabrapi.com.br/stores/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
--header "Authorization: SUA_API_KEY_AQUI"

​
📊 Exemplo de Resposta

{
	"status": true,
	"code": "SUCCESS",
	"store": {
		"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
		"name": "Minha Loja",
		"position": 1,
		"description": "Loja de exemplo",
		"image": "https://example.com/store.png",
		"template": "PERSONALIZADO",
		"domain": "minhaloja-web.cabrapi.com.br",
		"metadata": null,
		"ownerId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
		"createdAt": "2026-02-28T12:00:00.000Z",
		"updatedAt": "2026-02-28T12:00:00.000Z",
		"deletedAt": null,
		"categories": [],
		"products": [],
		"coupons": [],
		"payment": []
	}
}

​
❌ Possíveis Erros

StatusCodeQuando acontece
400INVALID_DATAQuando o storeId não é um UUID válido.
404STORE_NOT_FOUNDQuando a loja não existe, foi removida ou não pertence à sua conta.
500INTERNAL_SERVER_ERRORFalha interna ao processar a requisição.

​
Observacoes

  • categories, products e coupons retornam ordenados por position.

​
🔗 Links Úteis

Update: 28/02/2026 as 00:00