Produtos

Consultar um produto

GET /v1/products/{productId}

GET /v1/products/{productId}

Retorna o produto completo, incluindo todas as suas variantes com pricing. Escopo requerido: products:read.

Requisição

curl -X GET "https://api.selectwin.io/v1/products/prd_01hqzvabc" \
  -H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ"

Resposta 200 OK

{
  "id": "prd_01hqzvabc",
  "name": "Plano Premium",
  "slug": "plano-premium",
  "salesPage": "https://example.com/sales",
  "description": "Full access plan",
  "language": "pt-BR",
  "enabled": true,
  "salesQty": 42,
  "type": "digital",
  "category": "saas",
  "externalReference": null,
  "warrantyDays": 7,
  "images": ["https://example.com/img1.png"],
  "imageAssetIds": null,
  "createdAt": "2026-04-12T17:56:33.000Z",
  "updatedAt": "2026-04-12T17:56:33.000Z",
  "variants": [
    {
      "id": "var_01hqzvabc",
      "productId": "prd_01hqzvabc",
      "name": "Mensal",
      "slug": "mensal",
      "description": "Monthly billing",
      "sku": "SKU-M",
      "primary": true,
      "enabled": true,
      "pricing": {
        "unitPrice": 9900,
        "oldPrice": null,
        "costPerItem": 5000,
        "currency": "BRL",
        "schema": "unit",
        "type": "recurring",
        "billingType": "prepaid",
        "billingFrequency": "monthly",
        "billingFrequencyCount": 1
      },
      "images": null,
      "metadata": null,
      "attributes": null,
      "externalReference": null,
      "checkoutUrl": null,
      "createdAt": "2026-04-12T17:56:33.000Z",
      "updatedAt": "2026-04-12T17:56:33.000Z"
    }
  ]
}

Cada variante embutida no produto traz o objeto completo (incluindo productId, slug, primary, pricing.costPerItem, metadata, attributes e checkoutUrl) — o mesmo objeto retornado na leitura individual da variante (GET /v1/variants/{variantId}, veja Variantes). Campos não aplicáveis ou ausentes vêm null.

Erros

error.codeHTTPQuando
productNotFound404Produto não encontrado para esta conta
invalidParameters400productId com prefixo/formato inválido

Para listar vários produtos, veja Listar.

How is this guide?

On this page