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

# Listar produtos

> Listar todos os produtos da sua conta.

Esta rota permite listar todos os produtos da sua conta com opções de filtro e paginação.


## OpenAPI

````yaml GET /products
openapi: 3.1.0
info:
  title: Pepper API v1
  description: Documentação da API pública da Pepper.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.cloud.pepperpay.com.br/public/v1/
security:
  - bearerAuth: []
paths:
  /products:
    get:
      description: Listar todos os produtos da sua conta.
      parameters:
        - name: search
          in: query
          description: Pesquisar produtos por nome ou hash
          schema:
            type: string
        - name: categories
          in: query
          description: >-
            Filtre por categorias. Para pesquisar por mais de uma categoria,
            envie-as separadas por vírgula – Exemplo: ['1', '2', '3']
          schema:
            type: string
        - name: status
          in: query
          description: >-
            Filtre pelo status do produto. Valores: 1: Ativo, 2: Inativo, 3: Em
            revisão, 4: Bloqueado
          schema:
            type: string
        - name: perPage
          in: query
          description: 'Quantidade de produtos por página. Padrão: 30'
          schema:
            type: string
        - name: page
          in: query
          description: 'Número da página. Padrão: 1'
          schema:
            type: string
      responses:
        '200':
          description: Produtos listados com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        hash:
                          type: string
                          description: Hash ID único do produto
                        title:
                          type: string
                          description: Título do produto
                        description:
                          type: string
                          description: Descrição do produto
                        cover:
                          type: string
                          description: URL da imagem de capa do produto
                        id_category:
                          type: integer
                          description: ID da categoria do produto
                        product_type:
                          type: string
                          description: Tipo do produto
                        guaranted_days:
                          type: string
                          description: Dias de garantia do produto
                        sale_page:
                          type: string
                          description: URL da página de vendas do produto
                        offers:
                          type: array
                          description: Lista de ofertas associadas ao produto
                          items:
                            type: object
                            properties:
                              hash:
                                type: string
                                description: Hash ID da oferta
                              title:
                                type: string
                                nullable: true
                                description: Título da oferta
                              price:
                                type: integer
                                description: Preço da oferta em centavos
                              url:
                                type: string
                                description: URL do checkout dessa oferta
                              status:
                                type: integer
                                description: Status da oferta
                              interval:
                                type: string
                                nullable: true
                                description: Intervalo de recorrência da oferta
                              created_at:
                                type: string
                                description: Data de criação da oferta
                              updated_at:
                                type: string
                                description: Data de atualização da oferta
                        status:
                          type: integer
                          description: >-
                            Status do produto (1: Ativo, 2: Inativo, 3: Em
                            revisão, 4: Bloqueado)
                        support_name:
                          type: string
                          description: Nome do suporte do produto
                        support_email:
                          type: string
                          description: Email do suporte do produto
                        support_whatsapp:
                          type: string
                          nullable: true
                          description: WhatsApp do suporte do produto
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        description: URL da primeira página
                      last:
                        type: string
                        description: URL da última página
                      prev:
                        type: string
                        nullable: true
                        description: URL da página anterior
                      next:
                        type: string
                        nullable: true
                        description: URL da próxima página
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: Página atual
                      from:
                        type: integer
                        description: Primeiro item da página
                      last_page:
                        type: integer
                        description: Última página disponível
                      links:
                        type: array
                        description: Links de paginação
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                              nullable: true
                              description: URL da página
                            label:
                              type: string
                              description: Label da página
                            active:
                              type: boolean
                              description: Se a página está ativa
                      path:
                        type: string
                        description: Caminho base da API
                      per_page:
                        type: integer
                        description: Itens por página
                      to:
                        type: integer
                        description: Último item da página
                      total:
                        type: integer
                        description: Total de itens
              examples:
                success:
                  summary: Exemplo de resposta
                  value:
                    data:
                      - hash: abc123def
                        title: Curso de Marketing Digital
                        description: Um curso completo sobre marketing digital
                        cover: https://example.com/products/marketing-digital.jpg
                        id_category: 2
                        product_type: digital
                        guaranted_days: '7'
                        sale_page: https://exemplo.com.br
                        offers:
                          - hash: off123
                            title: null
                            price: 9900
                            url: https://go.pepper.com.br/off123
                            status: 1
                            interval: monthly
                            created_at: '2024-08-22 10:45:27'
                            updated_at: '2024-08-22 10:45:27'
                        status: 1
                        support_name: Suporte
                        support_email: suporte@exemplo.com
                        support_whatsapp: null
                      - hash: xyz789ghi
                        title: E-book de Vendas
                        description: Estratégias avançadas de vendas
                        cover: https://example.com/products/ebook-vendas.jpg
                        id_category: 1
                        product_type: digital
                        guaranted_days: '7'
                        sale_page: https://vendas.exemplo.com.br
                        offers:
                          - hash: off456
                            title: null
                            price: 500
                            url: https://go.pepper.com.br/off456
                            status: 1
                            interval: null
                            created_at: '2024-07-31 15:40:43'
                            updated_at: '2024-07-31 15:40:43'
                        status: 1
                        support_name: Time de Vendas
                        support_email: vendas@exemplo.com
                        support_whatsapp: null
                    links:
                      first: >-
                        https://api.cloud.pepperpay.com.br/public/v1/products?page=1
                      last: >-
                        https://api.cloud.pepperpay.com.br/public/v1/products?page=1
                      prev: null
                      next: null
                    meta:
                      current_page: 1
                      from: 1
                      last_page: 1
                      links:
                        - url: null
                          label: pagination.previous
                          active: false
                        - url: >-
                            https://api.cloud.pepperpay.com.br/public/v1/products?page=1
                          label: '1'
                          active: true
                        - url: null
                          label: pagination.next
                          active: false
                      path: https://api.cloud.pepperpay.com.br/public/v1/products
                      per_page: 50
                      to: 2
                      total: 2
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use o token da Pepper API no formato: `Bearer {seu_token_aqui}`'

````