Consultar suscripción activa del usuario

Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con type, id, attributes).

Tipo de recurso JSON:API. Siempre billing_subscription.

Identificador local de la suscripción, expresado como cadena.

Suscripción activa del usuario, con su origen, estado, ciclo y límites. Cada usuario tiene exactamente una. Los campos trial_*, cancel_* y stripe_subscription_id son nulos cuando no aplican.

Identificador único y legible del plan. Corresponde al plan activo del usuario.

Nombre del plan que muestran las interfaces.

Modelo de facturación del plan — free: Sin cobro; tiered: Cuota fija; metered: Cobro por consumo; hybrid: Cuota fija más consumo.

Origen de la suscripción — stripe: Pago mediante Stripe; admin_granted: Concesión administrativa; system_default: Plan asignado por el sistema.

Estado del ciclo de vida de la suscripción — active: Activa; trialing: En periodo de prueba; past_due: Con un cobro vencido y acceso todavía habilitado; canceled: Terminada; unpaid: Con cobros fallidos y sin acceso; incomplete: Primer pago pendiente; incomplete_expired: Primer pago vencido; paused: En pausa.

Timestamp ISO 8601 en UTC con sufijo Z explícito; por ejemplo, "2026-05-01T05:14:38Z". Los campos *_at, *_end, *_start y *_date adoptan esta forma. meta.datetime describe el mismo contrato en la respuesta.

Timestamp ISO 8601 en UTC con sufijo Z explícito; por ejemplo, "2026-05-01T05:14:38Z". Los campos *_at, *_end, *_start y *_date adoptan esta forma. meta.datetime describe el mismo contrato en la respuesta.

Moneda del precio — MXN: Pesos mexicanos; USD: Dólares estadounidenses.

Cadencia de facturación — once: Ciclo único, sin renovación automática; month: Cada mes; year: Cada año.

true cuando el usuario aceptó cobro por excedente en un plan hybrid. En ese caso, effective_limit salta de included_validations a monthly_validation_limit.

Validaciones incluidas en la cuota base antes del cobro por excedentes. null cuando el plan no tiene cuota base.

Tope de validaciones por ciclo de la suscripción. 0 no permite validaciones. En planes hybrid, es el tope duro cuando overage_enabled es true; cuando es false, effective_limit usa included_validations. En los demás modelos, es el límite efectivo salvo que exista un ajuste administrativo.

Tope de beneficiarios registrados por cuenta. -1 significa sin tope; desde 0, el valor se aplica como límite.

Cantidad máxima de validaciones por trabajo de importación. 0 no permite importar validaciones.

Límite efectivo de validaciones para el ciclo actual. Incorpora los ajustes administrativos y, en planes hybrid, la regla de overage_enabled. Es el valor contra el que se decide si una validación se atiende o se rechaza.

true cuando source es stripe.

Identificador de la suscripción en Stripe (sub_...). null cuando source no es stripe.

Motivo registrado cuando la suscripción fue otorgada por un administrador. null cuando source no es admin_granted.

true cuando la suscripción está programada para cancelarse al cierre del ciclo actual.

Fecha y hora programada para la cancelación, en ISO 8601 UTC. null cuando no hay una cancelación programada mediante cancel_at.

Fecha y hora en que la cancelación se consumó, en ISO 8601 UTC. null mientras la suscripción está activa.

Fecha y hora de inicio del periodo de prueba, en ISO 8601 UTC. null cuando no hay periodo de prueba.

Fecha y hora de fin del periodo de prueba, en ISO 8601 UTC. null cuando no hay periodo de prueba.

Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.

Versión de la API que procesó la petición.

Versión del prefijo de ruta de la API (ej. v1).

Identificador único de la petición (hex).

Descriptor compañero presente en el bloque meta de cada respuesta (y en el meta del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.

Siempre UTC: La zona canónica para cada campo datetime del cuerpo.

Siempre ISO 8601: Sufijo Z explícito en cada datetime.

Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.