API atual/Referência completa/Produtos do seller

Listar produtos

Devolve os produtos do seller com filtros, busca, ordenação e paginação.

Use esta rota para montar a grade de produtos do seller, conferir o que está pendente de aprovação ou sincronizar o catálogo com um sistema externo. O escopo é sempre o do token: não existe filtro por outro seller e vendor_id na consulta é ignorado.

GET/api/v1/vendor/productsSeller

Listar produtos do seller

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de consulta

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 20

Itens por página, de 1 a 100. Valor fora da faixa volta ao padrão.

sort_bystringpadrão: created_at

created_atpricenamesales_countrating_avgupdated_atquantitypopularitystatuscategory

Campo de ordenação.

sort_dirstringpadrão: desc

ascdesc

Sentido da ordenação.

searchstring

Texto livre no nome, SKU e descrição. Se não achar nada, a busca tenta por similaridade de significado.

statusstring

ADHRX

Filtra por status. Aceita a letra ou o nome (active, disabled, hidden, pending, rejected).

approval_statusstring

Apelido antigo de status. Só vale se status não for enviado.

category_idstring (uuid)

Somente produtos desta categoria.

skustring

Filtra por SKU.

min_priceinteger

Preço mínimo em centavos.

max_priceinteger

Preço máximo em centavos.

min_quantityinteger

Estoque mínimo.

max_quantityinteger

Estoque máximo.

free_shippingboolean

true ou 1 para só frete grátis.

has_imagesboolean

true ou 1 para só produtos com imagem.

low_stockboolean

true ou 1 para estoque baixo.

out_of_stockboolean

true ou 1 para sem estoque.

created_fromstring

Criados a partir desta data (RFC 3339 ou YYYY-MM-DD).

created_tostring

Criados até esta data.

updated_fromstring

Alterados a partir desta data.

updated_tostring

Alterados até esta data.

include_imagesboolean

false pula o carregamento das imagens, para listas mais rápidas.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/vendor/products?per_page=20&status=A" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Produtos retornados

json

{
  "products": [
    {
      "id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d",
      "display_id": 10664,
      "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
      "category_id": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
      "name": "Camiseta Básica Algodão Preta",
      "slug": "camiseta-basica-algodao-preta",
      "sku": "CAM-001",
      "barcode": "7891234567895",
      "description": "<p>Camiseta 100% algodão.</p>",
      "short_description": "Camiseta 100% algodão",
      "price": 4990,
      "list_price": 5990,
      "track_inventory": true,
      "quantity": 25,
      "low_stock_alert": 5,
      "min_quantity": 0,
      "max_quantity": 0,
      "quantity_step": 1,
      "sale_unit": "un",
      "zero_price_action": "P",
      "popularity": 0,
      "out_of_stock_action": "N",
      "weight": 0.25,
      "width": 30,
      "height": 2,
      "length": 40,
      "status": "A",
      "intended_status": "A",
      "approval_status": "approved",
      "view_count": 0,
      "sales_count": 0,
      "rating_avg": 0,
      "rating_count": 0,
      "free_shipping": false,
      "shipping_freight": 0,
      "requires_shipping": true,
      "vendor_name": "Loja Seller Teste",
      "vendor_slug": "loja-seller-teste",
      "created_at": "2026-10-11T20:56:24.231132Z",
      "updated_at": "2026-10-11T21:05:40.573283Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}

Campos da resposta

productsarray

Produtos da página, no mesmo formato de Consultar produto.

totalinteger

Total de produtos que atendem ao filtro.

pageinteger

Página devolvida.

per_pageinteger

Itens por página aplicado.

total_pagesinteger

Total de páginas.

Erros

Status	Quando	Corpo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	Token que não é de seller, ou usuário sem o privilégio exigido pela rota.	`{"error":"insufficient vendor privileges","privilege_required_any":["vendor_catalog"]}`
500	Falha ao consultar.	`{"error":"failed to list products","detail":"..."}`

Veja também