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

# Listar suscripciones

`GET /subscriptions`

Lista todas las suscripciones de tu cuenta con paginación, ordenadas de la más reciente a la más antigua.

## Query parameters

- `page` integer
- `items` integer

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Lista de suscripciones

- Subscription[]
  - `id` string — ID único de la suscripción
  - `description` string — Descripción de la suscripción
  - `status` 'active' | 'paused' | 'past_due' | 'cancelled' — Estado de la suscripción
  - `created_at` string, date-time — Fecha de creación
  - `updated_at` string, date-time — Última actualización
  - `current_period_start` string, date-time, nullable — Inicio del período de facturación actual
  - `current_period_end` string, date-time, nullable — Fin del período de facturación actual
  - `tax_name` string, nullable — Nombre fiscal del suscriptor
  - `tax_id` string, nullable — ID fiscal del suscriptor
  - `resumes_on` string, date, nullable — Fecha de reactivación automática (si está pausada)
  - `next_payment_attempt_at` string, date-time, nullable — Próximo intento de cobro automático (solo cuando el estado es `past_due`)
  - `payment_retries` integer — Número de reintentos de cobro realizados para el período actual. Recurrente intenta cobrar una vez al día por 15 días antes de cancelar la suscripción.
  - `metadata` union
    - string
    - number, double
    - boolean
  - `test_clock_id` string, nullable — ID del test clock heredado del Customer. Solo está presente en un Sandbox nombrado.
  - `default_payment_method` SubscriptionDefaultPaymentMethod — Método de pago predeterminado de la suscripción
    - `id` string — ID del método de pago
    - `type` string — Tipo de método de pago
    - `card` SubscriptionDefaultPaymentMethodCard
      - `last4` string — Últimos 4 dígitos de la tarjeta
      - `network` string — Red de la tarjeta
  - `subscriber` Subscriber
    - `id` string — ID del usuario suscriptor
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `full_name` string, nullable
    - `email` string, email
    - `phone_number` string, nullable
  - `checkout` SubscriptionCheckout
    - `id` string — ID del checkout que originó la suscripción
  - `product` SubscriptionProduct
    - `id` string — ID del producto asociado
  - `transfer_setups` TransferSetup[] — Transferencias automáticas recurrentes de esta suscripción. En cada cobro exitoso, cada una transfiere su `amount_percent` del total de la factura a la cuenta destinataria.
    - `id` string — ID de la configuración de transferencia
    - `status` 'pending' | 'completed' | 'cancelled' | 'reversed' — En pagos únicos: `pending` mientras el cobro no se completa y `completed` cuando la transferencia se ejecutó. En suscripciones la configuración queda `pending` mientras la suscripción está activa. `cancelled` si el checkout, la suscripción o un reembolso canceló el setup antes de ejecutarlo; `reversed` si un reembolso devolvió una transferencia ya completada.
    - `amount_in_cents` integer, nullable — Monto fijo en centavos a transferir (pagos únicos). No puede exceder el monto neto disponible después de fees, FEL e IVA.
    - `amount_percent` number, double, nullable — Porcentaje del total de cada factura a transferir (suscripciones).
    - `currency` string — Moneda
    - `recipient_id` string — ID de la cuenta de Recurrente que recibe los fondos (no es una cuenta bancaria).
    - `purpose` 'fund_split' | 'platform_commission' — Semántica comercial de la transferencia. Usa `platform_commission` únicamente cuando el checkout pertenece a una cuenta conectada y los fondos regresan a su plataforma; ese valor habilita la reconciliación y facturación diaria de la comisión.

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)