> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Assinaturas

> Retorna as assinaturas da conta (até 200), com status, fim do período e MRR.

#### Escopo

```bash theme={null}
read subscriptions
```

## O que faz

Retorna as assinaturas da conta (até 200), com status, fim do período e MRR.

## Casos de uso

* Controlar o acesso de assinantes
* Calcular a receita recorrente

## Resposta

**data** `object[]`

**campos**

**id** `string`

Identificador único.

**product\_id** `string`

**status** `string`

Estado atual.

**current\_period\_end** `string\<date-time\>`

Fim do período pago.

**mrr\_cents** `integer`

Receita mensal recorrente, em centavos.

**currency** `string`

Moeda: `BRL` ou `USD`.

**customer\_email** `string`

**created\_at** `string\<date-time\>`

Quando foi criado.

## Erros

| Status | Descrição |
| - | - |
| `401` | Chave inválida ou revogada. |
| `403` | Faltam escopos (`insufficient_scope`). |
| `429` | Limite de requisições (`rate_limited`). |

```bash cURL theme={null}
curl --request GET \
  --url https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/subscriptions \
  -u "$DPAY_CLIENT_ID:$DPAY_CLIENT_SECRET"
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "sub_3f2a",
      "product_id": "8f0c2a8e-1b7d-4a55-9a3e-1c2d3e4f5a6b",
      "status": "active",
      "current_period_end": "2026-12-06T18:05:00Z",
      "mrr_cents": 2990,
      "currency": "BRL",
      "customer_email": "comprador@exemplo.com",
      "created_at": "2026-11-06T18:05:00Z"
    }
  ]
}
```

```json 401 theme={null}
{ "error": "unauthorized", "message": "Chave de API inválida." }
```

```json 403 theme={null}
{ "error": "insufficient_scope", "message": "Esta chave precisa dos escopos: read, subscriptions." }
```


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