Venflow API
V1SuscripcionesPor IDCobro basado en uso

Consultar consumo de una suscripción

GET
/v1/subscriptions/{id}/usage

Authorization

Api-Key<token>

Tu clave API privada (comienza con pvk_)

In: header

Organization<token>

Tu ID de organización

In: header

Path Parameters

idstring
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.venflow.app/v1/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/usage"
{
  "data": [
    {
      "currency": "string",
      "meter_id": "string",
      "meter_name": "string",
      "pricing_model": "string",
      "total_usage": 0.1,
      "unbilled_amount": "string",
      "unit_amount": "string",
      "unit_label": "string"
    }
  ],
  "object": "list"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}

Deshacer una cancelación programada POST

Revierte una cancelación programada con `POST /v1/subscriptions/{id}/cancel`. - La suscripción vuelve a `active` y `cancel_at_period_end` queda en `false`, así que el próximo ciclo se cobra con normalidad. - Responde 400 si la suscripción no tiene una cancelación programada. Una suscripción **ya cancelada** no se deshace por aquí: se revive con `POST /v1/subscriptions/{id}/reactivate`. Revierte una cancelación agendada al final del período: la suscripción vuelve a estar activa y el próximo ciclo se cobra con normalidad. Una suscripción ya cancelada no se deshace por aquí, se revive con el endpoint de reactivación.

Listar eventos de uso de una suscripción GET

Devuelve el historial de eventos de uso registrados para la suscripción, ordenados por fecha del evento descendente. Soporta paginación y filtro opcional por rango de fechas: `from` (ISO 8601, inclusive) y `to` (ISO 8601, EXCLUSIVE — un evento con timestamp exactamente igual a `to` no entra, así un evento en el límite de facturación pertenece a un solo período).