Listar Assinaturas

Lista todas as assinaturas do cliente autenticado.

Retorna uma lista paginada de todas as assinaturas do cliente.

​

Autenticação

Requer Customer Session Token no header Authorization: Bearer cst_xxx.

​

Requisição

page · integer · default: "1"

Número da página.

limit · integer · default: "10"

Quantidade de itens por página (máximo 100).

active · boolean

Filtrar apenas assinaturas ativas.

cURL

curl -X GET "https://api.chargefy.io/api/v1/customer-portal/subscriptions/?page=1&limit=10" \
  -H "Authorization: Bearer cst_xxx"

​

Resposta

Resposta 200

{
  "items": [
    {
      "id": "sub_123",
      "status": "active",
      "product": {
        "id": "prod_abc",
        "name": "Plano Pro"
      },
      "price": {
        "amount": 9900,
        "currency": "BRL",
        "recurring_interval": "month"
      },
      "current_period_end": "2025-08-01T00:00:00Z",
      "cancel_at_period_end": false,
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total_count": 1,
    "page": 1,
    "max_page": 1
  }
}