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

# Detalles de una suscripción

> Obtén la información completa de una suscripción específica.

### Parámetros de Ruta

<ParamField path="subscription_id" type="string" required placeholder="9ddfcfc1-7b5e-490c-9731-4aabd986908e">
  ID único de la suscripción que deseas consultar
</ParamField>

### Response

<ResponseField name="id" type="string">
  Identificador único de la suscripción (UUID).
</ResponseField>

<ResponseField name="name" type="string">
  Nombre comercial de la suscripción.
</ResponseField>

<ResponseField name="status" type="string">
  Estado actual (`active`, `unpaid`, `pass_due`, `canceled`, `finished`, `frozen`).
</ResponseField>

<ResponseField name="description" type="string">
  Descripción enriquecida (puede contener HTML).
</ResponseField>

<ResponseField name="internal_id" type="string">
  Identificador interno que usas en tu sistema.
</ResponseField>

<ResponseField name="plan_id" type="string">
  ID del plan asociado, si aplica.
</ResponseField>

<ResponseField name="coupon_id" type="string">
  ID del cupón aplicado.
</ResponseField>

<ResponseField name="reference_price_in_cents" type="string">
  Precio de referencia en centavos como string.
</ResponseField>

<ResponseField name="currency" type="string">
  Moneda en formato ISO-4217 (ej. `COP`).
</ResponseField>

<ResponseField name="amount_in_cents" type="number">
  Valor base cobrado en cada ciclo.
</ResponseField>

<ResponseField name="cicle_frequency" type="string">
  Frecuencia de cobro: `weekly`, `monthly`, `annual`, etc.
</ResponseField>

<ResponseField name="cicles" type="number">
  Cantidad máxima de ciclos; `null` para indefinido.
</ResponseField>

<ResponseField name="current_cicle" type="number">
  Ciclo actual procesado.
</ResponseField>

<ResponseField name="allows" type="object">
  Configuración de métodos de pago permitidos para la suscripción.
</ResponseField>

<ResponseField name="suggest_auto_debit" type="boolean">
  Indica si se sugiere activar débito automático durante el onboarding del cliente.
</ResponseField>

<ResponseField name="start_date" type="date">
  Fecha programada de inicio.
</ResponseField>

<ResponseField name="end_date" type="date">
  Fecha de finalización si aplica.
</ResponseField>

<ResponseField name="trial" type="object">
  Información de periodo de prueba (`has_trial`, `trial_days`, `start_trial_date`).
</ResponseField>

<ResponseField name="payment_mode" type="string">
  Modo de cobro (`request`, `auto_debit`, etc.).
</ResponseField>

<ResponseField name="remember_to_pay_before" type="number">
  Días de anticipación para recordatorios de pago.
</ResponseField>

<ResponseField name="cancel_after_no_payment_before" type="number">
  Número de ciclos fallidos antes de cancelar automáticamente.
</ResponseField>

<ResponseField name="complex_payments" type="array">
  Pagos con valores diferenciados por ciclo.
</ResponseField>

<ResponseField name="metadata" type="object">
  Atributos personalizados que acompañan la suscripción.
</ResponseField>

<ResponseField name="customer" type="object">
  Resumen del cliente asociado.
</ResponseField>

<ResponseField name="plan" type="object">
  Información del plan enlazado, cuando existe.
</ResponseField>

<ResponseField name="created_at" type="date">
  Fecha de creación de la suscripción.
</ResponseField>

<ResponseField name="updated_at" type="date">
  Fecha de última actualización.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "9ddfcfc1-7b5e-490c-9731-4aabd986908e",
    "name": "SpectreSaaS",
    "status": "active",
    "description": "<p>1 Free</p><p>2 COP 449.000</p>",
    "internal_id": "SaaSSpectre",
    "plan_id": null,
    "coupon_id": null,
    "reference_price_in_cents": "44900000",
    "currency": "COP",
    "amount_in_cents": 44900000,
    "cicle_frequency": "monthly",
    "cicles": null,
    "current_cicle": 2,
    "allows": {
      "cards": true,
      "accounts": true,
      "card_extra": false,
      "realtime": false,
      "pse": true,
      "transfiya": true
    },
    "suggest_auto_debit": true,
    "start_date": "2025-01-05T00:00:00.000000Z",
    "end_date": null,
    "payment_mode": "request",
    "trial": {
      "has_trial": false,
      "start_trial_date": null,
      "trial_days": 0
    },
    "remember_to_pay_before": 3,
    "cancel_after_no_payment_before": 2,
    "complex_payments": [],
    "features": [],
    "metadata": null,
    "created_at": "2025-01-02T19:24:48.000000Z",
    "updated_at": "2025-02-05T16:01:24.000000Z",
    "customer": {
      "id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
      "first_name": "Empresa",
      "last_name": "SAS",
      "email": "empresa@empresa.com",
      "phone": "+573221234567",
      "document": "1234567890",
      "document_type": "RUT"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "message": "Registro no encontrado, Suscripción no existe",
    "code": 10002,
    "code_name": "record_not_found"
  }
  ```
</ResponseExample>