Lista as variantes de um produto

GET/v1/products/{productId}/variants

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros do caminho

productIdstringobrigatório
Identificador público (prd_/pro_…)

Parâmetros de consulta

limitinteger
Tamanho da página (itens por página).
offsetinteger
Posição do primeiro item (a partir de 0).
sortstring
Expressão de ordenação, ex.: "-createdAt"
daterangeum de
Criados neste dia (YYYY-MM-DD) ou neste instante.
daterangegtstring (date-time)
Criados depois deste instante (exclusivo).
daterangegtestring (date-time)
Criados a partir deste instante (inclusivo).
daterangeltstring (date-time)
Criados antes deste instante (exclusivo).
daterangeltestring (date-time)
Criados até este instante (inclusivo).
idstring
Só esta variante.
skustring
Só a variante com este SKU.
currencystring
Código de moeda ISO 4217
enabledboolean
Só variantes à venda (true) ou não (false).

Respostas

200Sucesso

dataobject[]obrigatório
Os itens desta página.
+17 campos de data
- idstringobrigatório
  Identificador público (var_/prv_…)
- skustringobrigatóriopode ser nulo
  O seu SKU; null quando não há.
- namestringobrigatóriopode ser nulo
  Nome da variante.
- slugstringobrigatóriopode ser nulo
  Slug da variante.
- fiscalobjectobrigatóriopode ser nulo
  O que a variante muda no perfil fiscal do produto; null = nada.
  +10 campos de fiscal
  - nbsstring
    Código NBS (serviço).
  - ncmstring
    Código NCM (mercadoria).
  - ceststring
    Código CEST (mercadoria).
  - gtinstring
    GTIN/EAN.
  - kindstring
    service (NFS-e) ou goods (NF-e).
    Valores:servicegoods
  - unitstring
    Unidade comercial.
  - origininteger
    Origem da mercadoria (0 a 8).
  - cClassTribstring
    Classificação tributária do IBS/CBS.
  - serviceCodestring
    Item da lista de serviços da LC 116.
  - cityServiceCodestring
    Código do serviço na sua prefeitura.
- imagesum de[]obrigatóriopode ser nulo
  URLs das imagens; null quando não há.
- enabledbooleanobrigatório
  Se a variante está à venda.
- pricingobjectobrigatório
  Preço e modelo de cobrança da variante.
  +22 campos de pricing
  - typestringobrigatório
    oneTime (uma venda) ou recurring (um plano de assinatura).
    Valores:oneTimerecurring
  - tiersanypode ser nulo
    As faixas de preço; null fora de tiered.
  - cyclesintegerobrigatóriopode ser nulo
    Número de ciclos até a assinatura acabar; null = até ser cancelada.
  - schemastringobrigatório
    Como o preço é calculado: unit, tiered ou package.
    Valores:unittieredpackage
  - currencystringobrigatório
    Moeda (ISO 4217).
  - oldPriceintegerobrigatóriopode ser nulo
    O preço antes de um desconto, em centavos; null quando não há.
  - daysTrialintegerobrigatóriopode ser nulo
    Duração do período de teste, em dias; null quando não há.
  - tiersModestringobrigatóriopode ser nulo
    graduated ou volume; null fora de tiered.
  - unitPriceintegerobrigatóriopode ser nulo
    Preço unitário, em centavos; null em tiered.
  - usageTypestringobrigatório
    licensed ou metered.
  - billingTypestringobrigatóriopode ser nulo
    Quando um ciclo é cobrado: prepaid, postpaid ou exactday; null em venda avulsa.
  - costPerItemintegerobrigatóriopode ser nulo
    O seu custo por unidade, em centavos; null quando não definido.
  - trialIntervalstringobrigatóriopode ser nulo
    Unidade da duração do teste; null quando não há.
  - meterEventNamestringobrigatóriopode ser nulo
    Nome do medidor de uso; null fora de metered.
  - billingExactDayintegerobrigatóriopode ser nulo
    Dia do mês em que o ciclo é cobrado; null quando não é fixo.
  - renewalShippingbooleanobrigatório
    Planos recorrentes: se o frete cotado no checkout é cobrado em cada renovação.
  - billingFrequencystringobrigatóriopode ser nulo
    Unidade do intervalo de cobrança; null em venda avulsa.
  - usageAggregationstringobrigatóriopode ser nulo
    Como o uso é agregado; null fora de metered.
  - transformQuantityanypode ser nulo
    Unidades por bloco e arredondamento; null fora de package.
  - trialIntervalCountintegerobrigatóriopode ser nulo
    Duração do teste, em unidades de trialInterval; null quando não há.
  - billingFrequencyCountintegerobrigatóriopode ser nulo
    Quantas unidades por ciclo; null em venda avulsa.
  - renewalMethodDiscountbooleanobrigatório
    Planos recorrentes: se o desconto do meio de pagamento do checkout se estende às renovações.
- primarybooleanobrigatório
  Se é a variante principal do produto.
- metadataobjectobrigatóriopode ser nulo
  Os seus metadados chave-valor; null quando não há.
- createdAtstringobrigatório
  Quando o recurso foi criado (ISO 8601, UTC).
- productIdstringobrigatório
  O produto a que a variante pertence.
- updatedAtstringobrigatório
  Quando o recurso foi atualizado pela última vez (ISO 8601, UTC).
- attributesobjectobrigatóriopode ser nulo
  Atributos livres da variante; null quando não há.
- checkoutUrlstringobrigatóriopode ser nulo
  URL do checkout hospedado desta variante; null quando não há.
- descriptionstringobrigatóriopode ser nulo
  Descrição; null quando não há.
- externalReferencestringobrigatóriopode ser nulo
  O seu próprio identificador da variante; null quando não há.
pageobjectobrigatório
Cursores de paginação da lista.
+3 campos de page
- totalintegerobrigatório
  Número total de páginas.
- offsetobjectobrigatório
  O offset para pedir a primeira, a anterior, a próxima e a última página.
  +4 campos de offset
  - lastintegerobrigatório
    Posição da última página.
  - nextintegerobrigatório
    Posição da próxima página (fica nesta quando ela é a última).
  - previntegerobrigatório
    Posição da página anterior (0 na primeira).
  - firstintegerobrigatório
    Posição da primeira página.
- currentintegerobrigatório
  Número da página atual (a primeira é 1).
limitintegerobrigatório
Tamanho da página, como pedido.
totalintegerobrigatório
Número total de itens que atendem aos filtros.
offsetintegerobrigatório
Posição do primeiro item desta página, como pedido.
hasMorebooleanobrigatório
true quando há mais itens depois desta página.

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorExclui uma variante de produto PróximaCria uma variante de produto