---
title: "Obtener una suscripción"
method: GET
path: "/subscriptions/{id}"
tags: ["subscriptions"]
---

# Obtener una suscripción

`GET /subscriptions/{id}`

Obtén los detalles de una suscripción específica.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Detalles de la suscripción

- 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' — Qué representa la transferencia. `fund_split` (el valor predeterminado) es una distribución ordinaria de fondos: enruta parte del cobro a otra cuenta, sin más consecuencias. `platform_commission` marca la transferencia como la comisión que una cuenta conectada paga a su plataforma — es lo que crean `application_fee_amount` / `application_fee_percent` — y cambia tres comportamientos: solo puede fluir de la cuenta conectada hacia su plataforma (sobre una conexión activa), es la única que un reembolso revierte con `refund_application_fee: true`, y se incluye en la facturación diaria de comisiones (DTE) cuando la conexión la tiene habilitada.
  - `application_fee_percent` number, double, nullable — Comisión de plataforma como porcentaje del total de cada factura. `null` cuando la suscripción no paga comisión.

## Changes

- **2026-09-02** `da12dce50f30` — 1 info
  - added the optional property `application_fee_percent` to the response with the `200` status

[Change history](https://skmtc.dev/recurrente/apis/referencia-api/changes/subscriptions/:id/get.md)

---

[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/da12dce50f30/schema)