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

# Listar Produtos

> Retorna uma lista de produtos cadastrados de forma paginada e simplificada, com seus respectivos tipos e skus.

### Query Parameters

<ParamField query="page" type="number" default="1">Paginação usando cursores.</ParamField>
<ParamField query="limit" type="number" default="10">Limite de itens retornáveis.</ParamField>
<ParamField query="category" type="string">Busca pela taxonomia.</ParamField>
<ParamField query="status" type="string">Status do produto (ex: `APPROVED`).</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "cffbca85-da89-4b2a-aecf-31422abcb34a",
        "sku": "PROD-123",
        "commercialName": "Cabo USB-C",
        "type": "SIMPLE",
        "status": "APPROVED",
        "price": 150.00
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 10
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /products
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /products:
    get:
      tags:
        - Products
      summary: List products with filters and cursor pagination
      operationId: ProductController_findAll
      parameters:
        - name: search
          required: false
          in: query
          description: Search term for name or SKU
          schema:
            type: string
        - name: category
          required: false
          in: query
          description: Filter by category
          schema:
            type: string
        - name: status
          required: false
          in: query
          description: Filter by status
          schema:
            type: string
            enum:
              - ACTIVE
              - INACTIVE
        - name: companyId
          required: false
          in: query
          description: Filter by company ID
          schema:
            type: string
        - name: channel
          required: false
          in: query
          description: Filter by channel
          schema:
            type: string
        - name: onlyTemplates
          required: false
          in: query
          description: Return only variation templates
          schema:
            type: boolean
        - name: onlySellable
          required: false
          in: query
          description: Return only sellable products (excludes templates)
          schema:
            type: boolean
        - name: excludeTemplates
          required: false
          in: query
          description: Explicitly exclude templates
          schema:
            type: boolean
        - name: cursor
          required: false
          in: query
          description: Cursor for pagination (next page starts after this seqId)
          schema:
            type: number
        - name: limit
          required: false
          in: query
          description: Number of items per page
          schema:
            default: 50
            type: number
      responses:
        '200':
          description: Return list of products and metadata.

````