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

# Listar Produtos

> Lista todos os produtos cadastrados na conta

## Visão Geral

Este endpoint retorna uma lista paginada de todos os produtos cadastrados na sua conta KlivoPay.

## Endpoint

```
GET https://api.klivopay.com.br/api/public/v1/products
```

## Parâmetros

<ParamField query="api_token" type="string" required>
  Seu token de autenticação da API KlivoPay
</ParamField>

<ParamField query="page" type="integer" default="1">
  Número da página para paginação
</ParamField>

<ParamField query="per_page" type="integer" default="20">
  Quantidade de itens por página (máximo: 100)
</ParamField>

## Exemplo de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET 'https://api.klivopay.com.br/api/public/v1/products?api_token=seu_token_aqui&page=1&per_page=20'
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    api_token: 'seu_token_aqui',
    page: 1,
    per_page: 20
  });

  const response = await fetch(`https://api.klivopay.com.br/api/public/v1/products?${params}`);
  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  url = 'https://api.klivopay.com.br/api/public/v1/products'
  params = {
      'api_token': 'seu_token_aqui',
      'page': 1,
      'per_page': 20
  }

  response = requests.get(url, params=params)
  print(response.json())
  ```

  ```php PHP theme={null}
  <?php
  $params = http_build_query([
      'api_token' => 'seu_token_aqui',
      'page' => 1,
      'per_page' => 20
  ]);

  $url = 'https://api.klivopay.com.br/api/public/v1/products?' . $params;
  $response = file_get_contents($url);
  print_r(json_decode($response));
  ?>
  ```
</CodeGroup>

## Resposta de Sucesso

```json 200 OK theme={null}
{
  "success": true,
  "data": [
    {
      "hash": "prod123abc",
      "title": "Curso de Marketing Digital",
      "cover": "https://cdn.klivopay.com.br/products/cover123.jpg",
      "product_type": "digital",
      "payment_type": 1,
      "amount": 29900,
      "category": {
        "id": 5,
        "name": "Educação"
      },
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "hash": "prod456def",
      "title": "E-book Vendas Online",
      "cover": "https://cdn.klivopay.com.br/products/cover456.jpg",
      "product_type": "digital",
      "payment_type": 1,
      "amount": 4900,
      "category": {
        "id": 5,
        "name": "Educação"
      },
      "created_at": "2025-01-10T14:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 12,
    "total_pages": 1
  }
}
```

## Códigos de Resposta

<ResponseField name="200" type="OK">
  Lista de produtos retornada com sucesso
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Token de API inválido ou ausente
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Erro interno do servidor
</ResponseField>