Obtener una suscripción

GET

https://app.recurrente.com/api/subscriptions/:id

GET

/api/subscriptions/:id

curl https://app.recurrente.com/api/subscriptions/id \
     -H "X-SECRET-KEY: <apiKey>"

200Retrieved

{
  "id": "su_nehndm7j",
  "description": "One Free-Testable Banana",
  "status": "active",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "current_period_start": "2024-01-15T09:30:00Z",
  "current_period_end": "2024-01-15T09:30:00Z",
  "tax_name": "string",
  "tax_id": "string",
  "resumes_on": "2023-01-15",
  "next_payment_attempt_at": "2024-01-15T09:30:00Z",
  "payment_retries": 0,
  "metadata": {},
  "test_clock_id": "string",
  "default_payment_method": {
    "id": "pay_m_7v5ie3pw",
    "type": "card",
    "card": {
      "last4": "4242",
      "network": "visa"
    }
  },
  "subscriber": {
    "id": "us_rdctav2g",
    "first_name": "string",
    "last_name": "string",
    "full_name": "Fela Kuti",
    "email": "test@user.com",
    "phone_number": "string"
  },
  "checkout": {
    "id": "string"
  },
  "product": {
    "id": "string"
  },
  "transfer_setups": [
    {
      "id": "tr_4a7b9c8d",
      "status": "pending",
      "amount_in_cents": 1,
      "amount_percent": 1.1,
      "currency": "string",
      "recipient_id": "ac_123456",
      "purpose": "fund_split"
    }
  ],
  "application_fee_percent": 10
}

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

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

idstringRequired

ID de la suscripción

Response

Detalles de la suscripción

idstringOptional

ID único de la suscripción

descriptionstringOptional

Descripción de la suscripción

statusenumOptional

Estado de la suscripción

Allowed values:

created_atdatetimeOptional

Fecha de creación

updated_atdatetimeOptional

Última actualización

current_period_startdatetime or nullOptional

Inicio del período de facturación actual

current_period_enddatetime or nullOptional

Fin del período de facturación actual

tax_namestring or nullOptional

Nombre fiscal del suscriptor

tax_idstring or nullOptional

ID fiscal del suscriptor

resumes_ondate or nullOptional

Fecha de reactivación automática (si está pausada)

next_payment_attempt_atdatetime or nullOptional

Próximo intento de cobro automático (solo cuando el estado es past_due)

payment_retriesintegerOptional

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.

metadatastring or double or booleanOptional

Metadata persistida durante todo el ciclo de vida de la suscripción y expuesta en sus webhooks.

test_clock_idstring or nullOptional

ID del test clock heredado del Customer. Solo está presente en un Sandbox nombrado.

default_payment_methodobject or nullOptional

Método de pago predeterminado de la suscripción

subscriberobjectOptional

checkoutobject or nullOptional

productobjectOptional

transfer_setupslist of objectsOptional

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.

application_fee_percentdouble or nullOptional

Comisión de plataforma como porcentaje del total de cada factura. null cuando la suscripción no paga comisión.