Listar suscripciones
GET https://api.geopagos.io/api/v1.0/subscriptions
Query params
| Parámetro | Requerido | Descripción |
|---|---|---|
| limit | Sí | — |
| offset | Sí | — |
| planId | No | Filtra por plan |
| customerId | No | Filtra por cliente |
| status | No | — |
| createdAt | No | Fecha ISO 8601 |
| createdBefore | No | Fecha ISO 8601 |
| search | No | Búsqueda por nombre, email, documento o referencia externa del cliente |
Nota: Filtro de fecha en el documento original
El resumen de convenciones menciona createdAfter, pero la tabla de este endpoint indica createdAt. Se conserva la tabla original; confirmá el nombre del filtro con el equipo de Sipago antes de utilizarlo.
Response 200
{
"data": [
{
"subscription_id": "sub_123",
"customer_id": "cus_456",
"plan_id": "plan_123",
"payment_method_id": "pm_789",
"status": "active",
"start_date": "2026-01-01T00:00:00Z",
"current_period_start": "2026-07-01T00:00:00Z",
"current_period_end": "2026-08-01T00:00:00Z",
"next_billing_date": "2026-08-01T00:00:00Z",
"billing_cycles_completed": 6,
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-07-01T00:00:00Z"
}
],
"pagination": { "total": 1, "limit": 20, "offset": 0 }
}
Campos completos de cada suscripción: subscription_id, customer_id, plan_id, payment_method_id?, status, start_date, trial_end_date?, current_period_start, current_period_end, next_billing_date?, end_date?, cancelled_at?, billing_cycles_completed, billing_cycles_remaining?, last_amount?, next_amount?, next_amount_description?, external_reference?, terms_acceptance?, metadata?, created_at, updated_at.