subscriptions

Listar suscripciones

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

get/subscriptions

Query parameters

pageinteger

Número de página (empezando en 1)

itemsinteger

Elementos por página

Headers

X-SECRET-KEYstring required

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.

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.

Response

Lista de suscripciones

idstring

ID único de la suscripción

descriptionstring

Descripción de la suscripción

status'active' | 'paused' | 'past_due' | 'cancelled'

Estado de la suscripción

created_atstring date-time

Fecha de creación

updated_atstring date-time

Última actualización

current_period_startstring date-time nullable

Inicio del período de facturación actual

current_period_endstring date-time nullable

Fin del período de facturación actual

tax_namestring nullable

Nombre fiscal del suscriptor

tax_idstring nullable

ID fiscal del suscriptor

resumes_onstring date nullable

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

next_payment_attempt_atstring date-time nullable

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

payment_retriesinteger

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.

test_clock_idstring nullable

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

Changes

No recorded changes to this endpoint across all 1 revision of this API.