---
title: "GET /public_api/subscriptions/"
method: GET
path: "/public_api/subscriptions/"
tags: ["subscriptions"]
---

# GET /public_api/subscriptions/

`GET /public_api/subscriptions/`

Lista assinaturas da conta com filtros, busca e paginação.

## Query parameters

- `limit` integer
- `page` integer
- `search` string
- `ordering` 'status' | 'amount' | 'paymentMethod' | 'createdAt' | 'updatedAt' | 'canceledAt' | 'next_payment_date'
- `status` 'active' | 'inactive' | 'canceled' | 'expired' | 'paused' | 'trial' — * `active` - Ativa * `inactive` - Inativa * `canceled` - Cancelada * `expired` - Expirada * `paused` - Pausada * `trial` - Em período de teste
- `paymentMethod` string
- `current_situation` 'new' | 'renewed'

## Response `200`

Lista de assinaturas retornada com sucesso.

- PaginatedSubscriptionOwnerFlexList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SubscriptionOwnerFlex[]
    - `id` string, required — Identificador único da assinatura
    - `status` 'active' | 'inactive' | 'canceled' | 'expired' | 'paused' | 'trial', required — * `active` - Ativa * `inactive` - Inativa * `canceled` - Cancelada * `expired` - Expirada * `paused` - Pausada * `trial` - Em período de teste
    - `current_period` integer — Período atual da assinatura
    - `recurrence_period` integer — Quantidade de dias entre cada cobrança
    - `quantity_recurrences` integer — Quantidade total de recorrências configuradas
    - `trial_days` integer — Dias de teste configurados na assinatura
    - `max_retries` integer — Número máximo de tentativas de cobrança
    - `amount` string, decimal, required — Valor da assinatura
    - `retry_interval` integer — Intervalo entre tentativas de cobrança
    - `paid_payments_quantity` integer — Quantidade de pagamentos já efetuados
    - `retention` string — Tempo em que a assinatura permaneceu ativa
    - `parent_order` object, required — Pedido de origem da assinatura
    - `paymentMethod` object, required — Método de pagamento usado na assinatura
    - `customer` object, required — Cliente associado à assinatura
    - `product` object, required — Produto associado à assinatura
    - `offer` object, required — Oferta associada à assinatura
    - `orders` object[] — Pedidos vinculados à assinatura
    - `next_payment_date` string, date-time, nullable — Data estimada do próximo pagamento
    - `createdAt` string, date-time, required — Data de criação
    - `updatedAt` string, date-time, required — Data da última atualização
    - `canceledAt` string, date-time, nullable — Data de cancelamento

## Other responses

- `401` — Request não autenticado devido à ausência ou invalidez do token.

---

[API](https://skmtc.net/cakto/apis/cakto-api.md) · [All operations](https://skmtc.net/cakto/apis/cakto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cakto/cakto-api/versions/cba77b0560b5/schema)