Referência da API
Buscar oferta
Retorna a Offer completa com o Product vinculado e um bloco `stats` que inclui `canEditSnapshotFields` — `true` se a Offer não tem dependentes ativos e você pode editar `amount`/`billingCycle`/etc; `false` caso contrário.
GET
/v2/offers/:idAutenticação
HTTP Basic Auth. Envie sua secret key no header:
Authorization: Basic {base64(secret:SUA_SECRET_KEY)}Parâmetros
idstring (path, UUID)obrigatórioUUID da Offer.
Exemplo: off_xyz789
Respostas
200
Offer encontrada com Product embedded e stats.
JSON
{
"id": "off_xyz789",
"productId": "prd_111aaa-bbb-ccc",
"name": "Mensal 12x",
"amount": 4900,
"billingCycle": "MONTHLY",
"billingCycleCount": 1,
"maxCycles": 12,
"trialDays": 7,
"active": true,
"createdAt": "2026-05-26T14:38:00.000Z",
"product": {
"id": "prd_111aaa-bbb-ccc",
"name": "Curso de Marketing Digital",
"description": "...",
"imageUrl": "..."
},
"stats": {
"activeSubscriptions": 47,
"activePaymentLinks": 2,
"canEditSnapshotFields": false
}
}404
Offer não encontrada.
JSON
{ "status": 404, "error": "Oferta nao encontrada" }Exemplos
cURL
curl -X GET "https://api.pagnovo.com/v2/offers/off_xyz789" \
-H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"