Listar planos
Um plano é um produto do tipo SUBSCRIPTION — aparece aqui, não em GET /products.
Sem campo de autorização: o portal autentica por você com a sua chave de Homologação e as requisições rodam só no ambiente de testes.
Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer ". Vale 24 horas.
In: header
Query Parameters
Número da página, começando em 1.
11 <= valueItens por página, de 1 a 100.
251 <= value <= 100true lista só os ativos; false, só os inativos. Sem o filtro, lista os dois.
Nome do plano. Busca por parte do texto, sem diferenciar maiúsculas de minúsculas.
1 <= length <= 255Response Body
curl -X GET "https://pagpolar-api.creativecode.dev.br/v1/plans?page=1&per_page=25&is_active=true&name=string"{
"data": [
{
"id": "c4d5e6f7-a8b9-4c0d-1e2f-3a4b5c6d7e8f",
"name": "Curso de Marketing Digital",
"description": "Aprenda a vender online do zero",
"author": "João Silva",
"promotional_text": "Oferta por tempo limitado",
"is_active": true,
"image": "https://api.pagpolar.com/files/abc123.png",
"type": "DIGITAL",
"content_type": "COURSE",
"warranty_time": 7,
"category": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "Cursos"
},
"created_at": "2026-01-15T12:00:00.000Z",
"updated_at": "2026-02-01T09:30:00.000Z"
}
],
"meta": {
"page": 1,
"per_page": 25,
"total": 143,
"total_pages": 6
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}Listar ofertas de um plano GET
`id` precisa ser o id (uuid) de um plano da sua conta — planos de outro whitelabel retornam 404.
Editar oferta de plano PATCH
Edita campos comerciais de uma oferta de plano já criada. Envie apenas os campos que deseja atualizar (edição parcial) — o corpo não pode vir vazio. Não é possível alterar `product_id` ou `is_default` por aqui — a troca de oferta padrão continua sendo feita apenas pelo painel.