Listar suscripciones

get/v1/subscriptions

Request

BASH

curl https://api.cauril.com/v1/subscriptions \
  -H "Authorization: Bearer sk_test_..."

Parámetros

statusquery	SubscriptionStatus
customer_idquery	string
plan_idquery	string
limitquery	integer	1–100 (default 20).
starting_afterquery	string	Cursor: el id del último elemento de la página anterior.

Respuestas

200	Lista paginada de suscripciones	SubscriptionList
401	Error	Error

Ejemplo de respuesta · 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "subscription",
      "id": "sub_01J...",
      "status": "incomplete",
      "customer_id": "cus_01J...",
      "plan_id": "plan_01J...",
      "provider": "stripe",
      "engine": "native",
      "current_period_start": "2026-06-01T12:00:00Z",
      "current_period_end": "2026-06-01T12:00:00Z",
      "cancel_at_period_end": true,
      "trial_end": null,
      "provider_subscription_id": null,
      "metadata": {},
      "latest_invoice": null,
      "created_at": "2026-06-01T12:00:00Z",
      "updated_at": "2026-06-01T12:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": null
}