Listar opções de troca de plano

Lista os planos do mesmo produto disponíveis para troca (upgrade ou downgrade) nesta assinatura, e se o produto permite troca de plano pelo cliente.

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.

GET
/subscriptions/{id}/plan-options
AuthorizationBearer <token>

Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer ". Vale 24 horas.

In: header

Path Parameters

idstring
Formatuuid

Response Body

curl -X GET "https://pagpolar-api.creativecode.dev.br/v1/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/plan-options"
{
  "data": {
    "allow_client_plan_change": true,
    "current_product_price_id": "d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a",
    "options": [
      {
        "id": "d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a",
        "identifier": "PPP1234567890",
        "title": "Plano Mensal",
        "price": 197.9,
        "is_active": true,
        "requires_shipping": false,
        "is_default": false,
        "product_id": "c4d5e6f7-a8b9-4c0d-1e2f-3a4b5c6d7e8f",
        "payment_methods": {
          "pix": true,
          "credit_card": true,
          "billet": false
        },
        "max_credit_card_installments": 12,
        "cycle": "MONTHLY",
        "cycle_interval": 1,
        "cycle_interval_limit": 12,
        "allow_purchase_quantity": false,
        "purchase_quantity_limit": 10,
        "purchase_quantity_min": 1,
        "expires_at": null,
        "created_at": "2026-01-10T10:00:00.000Z"
      }
    ]
  }
}
{
  "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"
  }
}
{
  "error": {
    "code": "invalid_request",
    "message": "string",
    "request_id": "string"
  }
}