Documentação da API v1 · Conheça a Naut
v1

Listar produtos

Devolve o catálogo em páginas. Produtos arquivados ficam de fora por padrão e só aparecem quando você os pede.

GEThttps://api.navenaut.com/products/

Autenticação

A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.

Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.

Exige sessão de vendedor. O dono do produto vem do vínculo da sessão, nunca da requisição.

Parâmetros

Consulta

NomeTipoDescrição
limitinteiroQuantos produtos trazer nesta página.
cursortexto (uuid)O ponteiro devolvido pela página anterior. Sem ele, a listagem começa do início.
includeArchivedbooleanoTraga também os produtos arquivados.

Respostas

200 · sucesso

{
  "items": [
    {
      "acceptedMethods": [
        "pix"
      ],
      "affiliateProgram": {
        "clickModel": "first",
        "commissionBps": 1,
        "cookieDays": 30,
        "description": "exemplo",
        "enabled": true,
        "manualApproval": true,
        "onBump": true,
        "onUpsell": true,
        "rules": "exemplo",
        "supportEmail": "comprador@exemplo.com.br"
      },
      "archivedAt": "2026-01-15T12:00:00.000Z",
      "billingType": "one_time",
      "category": "Saúde e Esportes",
      "createdAt": "2026-01-15T12:00:00.000Z",
      "deliveryInstructions": "exemplo",
      "deliveryMode": "members",
      "description": "exemplo",
      "id": "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06",
      "imageUrl": "https://loja.exemplo.com.br/webhooks",
      "installmentExtraBps": 0,
      "installmentLimit": 1,
      "name": "Loja Exemplo",
      "offers": [
        {
          "createdAt": "2026-01-15T12:00:00.000Z",
          "id": "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06",
          "interval": {
            "count": 1,
            "unit": "week"
          },
          "name": "Loja Exemplo",
          "position": 1,
          "price": {
            "amountCents": 129900,
            "currency": "BRL"
          },
          "principal": true,
          "publicId": "7K3M9X",
          "status": "active"
        }
      ],
      "pixRecoveryEmailEnabled": true,
      "price": {
        "amountCents": 129900,
        "currency": "BRL"
      },
      "publicId": "7k3m9x",
      "showAllOffers": true,
      "statementDescriptor": "exemplo",
      "status": "draft",
      "updatedAt": "2026-01-15T12:00:00.000Z",
      "warrantyDays": 7
    }
  ],
  "nextCursor": "exemplo"
}

Próximo passo