---
title: "Listar todas as assinaturas"
method: GET
path: "/recurrence/subscriptions/"
tags: ["Assinaturas"]
---

# Listar todas as assinaturas

`GET /recurrence/subscriptions/`

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Assinaturas listadas com sucesso

- PageSubscriptionCreatedDTO
  - `items` SubscriptionCreatedDTO[], required
    - `subscription_id` string, required — Id da assinatura.
    - `payment_method` string, required — Meio de pagamento utilizado na assinatura.
    - `interval_count` integer, required — Número de intervalos de acordo com a propriedade interval entre cada cobrança da assinatura. Ex.: plano mensal = interval_count (1)
    - `plan_id` string, nullable — Id do plano assinado.
    - `current_cycle` SubscriptionCurrentCycleDTOOutput, required
      - `start_at` string, date-time, required — Data inicial da asssinatura.
      - `end_at` string, date-time, nullable — Data final da asssinatura.
    - `billing_type` string, required
    - `next_billing_at` string, date-time — Data do próximo faturamento da assinatura.
    - `installments` integer, nullable — Quantidade de parcelas aplicádas ao cartão de crédito.
    - `customer` ZpyEnterpriseResourcesDomainPaymentOrderModelValueObjectsOrderValueObjectsCustomer
      - `name` string, required
      - `email` string, nullable
      - `phone` string, nullable
      - `document` string, nullable
      - `birthdate` string, date-time, nullable
      - `address` CustomerAddress
        - `zip_code` string, required
        - `line_1` string, required
        - `line_2` string, nullable, required
        - `state` string, required
        - `city` string, required
        - `metadata` object, nullable
      - `external_id` string, nullable
      - `metadata` object, nullable
    - `card` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosCardResponseDTO
      - `last_four_digits` union, required
        - string
        - integer
      - `brand` string, nullable, required
      - `holder_name` string, nullable, required
      - `exp_month` integer, nullable, required
      - `exp_year` integer, nullable, required
      - `status` string, nullable
      - `billing_address` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosAddressResponseDTO, required
        - `zip_code` string, required
        - `state` string, required
        - `city` string, required
        - `line_1` string, nullable
        - `line_2` string, nullable
        - `metadata` object
      - `type` string, nullable
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `external_id` string, nullable — Id externo.
    - `items` PlanItemCreatedDTO[], required
      - `product_id` string, required — Id do produto criado.
      - `amount` string, required — Valor unitário do produto criado
      - `description` string — Descrição do produto criado
      - `type` string — Tipo do produto criado
      - `status` string — Status do item criado
      - `metadata` object — Dados adicionais do produto criado
    - `status` string
    - `created_at` string, date-time, required — Data de criação da assinatura.
    - `updated_at` string, date-time, required — Data de atualização da assinatura.
    - `metadata` object, nullable — Dados adicionais da assinatura.
    - `first_payment` FirstPaymentDTOOutput
      - `amount` string, nullable — Valor do primeiro pagamento (opcional).
      - `due_date` string, date-time, nullable — Data de vencimento do primeiro pagamento (opcional).
    - `payment_method_params` PaymentMethodParamsDTO
      - `acceptance_deadline` string, date-time, nullable — Prazo de aceitação do pagamento (opcional).
      - `type` string, nullable — Tipo de pagamento PIX. Valores possíveis: qrcode_and_payment, payment_and_or_qrcode. Obrigatório quando payment_method=pix.
    - `payment_method_data` PaymentMethodDataDTO
      - `qr_code_url` string, nullable — URL do QR Code PIX (opcional, apenas para PIX).
      - `qr_code_data` string, nullable — Dados do QR Code PIX em base64 (opcional, apenas para PIX).
      - `expiration_date` string, date-time, nullable — Data de expiração do QR Code PIX (opcional, apenas para PIX).
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422` — Validation Error

---

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