> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Assinaturas

> Lista todas as assinaturas do cliente autenticado.

Retorna uma lista paginada de todas as assinaturas do cliente.

## Autenticação

> [!NOTE]
>
> 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.

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

## Resposta

```json Resposta 200 theme={null}
{
  "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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.