> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Produtos

> Lista os produtos do catálogo da sua loja, com preço em reais, estoque disponível e variações.

Retorna os produtos do catálogo da sua loja. Use o `id` de cada produto para montar pedidos.

**Método:** `GET /api/v1/products`

**Autenticação:** Obrigatória — inclua o header `Authorization: Bearer sk_live_sua_api_key`.

## Exemplo de requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/products' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "products": [
    {
      "id": "9d40e409-28e6-481f-aafc-83f97b831f07",
      "name": "Produto Exemplo",
      "slug": "produto-exemplo",
      "description": "Descrição do produto",
      "price": 100,
      "comparativePrice": "129.90",
      "stock": 50,
      "category_id": "3f1c8e2a-55d4-4a1b-9c77-2e0b9a6d4f11",
      "image": "https://exemplo.com/capa.png",
      "images": [],
      "type": "normal",
      "variations": [],
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}
```

## Campos

<ResponseField name="price" type="number">
  Preço **em reais**, com decimais. `100` = R\$100,00 e `19.9` = R\$19,90.
</ResponseField>

<ResponseField name="stock" type="number | null">
  Quantidade disponível. `null` significa estoque ilimitado.
</ResponseField>

<ResponseField name="type" type="string">
  `normal` para produto simples, `variable` para produto com variações.
</ResponseField>

<ResponseField name="variations" type="object[]">
  Variações do produto, cada uma com `id`, `name`, `price` e `stock` próprios. Ao montar um pedido de produto `variable`, informe o `id` da variação escolhida.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.