Skip to main content
GET
Consultar produto

Autorizações

Authorization
string
header
obrigatório

Chave secreta da conta: Authorization: Bearer sk_test_… ou sk_live_…. Use só no servidor.

Parâmetros de caminho

productID
string<uuid>
obrigatório

ID do produto.

Resposta

O produto.

Um item do catálogo. O preço fica nas versões do produto.

id
string<uuid>
key
string | null

Chave estável que você escolhe para o produto, única na sua conta. Permite criar o mesmo produto de novo sem duplicar.

name
string
type
enum<string>

item (padrão) ou agent.

Opções disponíveis:
agent,
item
description
string | null
pricingModel
enum<string>

Como o produto é cobrado: subscription, one_time, usage ou prepaid.

Opções disponíveis:
subscription,
one_time,
usage,
prepaid
currency
string

Código ISO 4217 de 3 letras, como BRL.

Exemplo:

"BRL"

status
string

active ou archived.

Exemplo:

"active"

imageUrl
string | null

Endereço público da foto do produto.

requiresShipping
boolean

Se a compra exige entrega física; quando true, o checkout pede endereço.

createdAt
string<date-time>
updatedAt
string<date-time>