Venflow API
V1SuscripcionesPor IDCobro basado en usoEventos

Listar eventos de uso de una suscripción

GET
/v1/subscriptions/{id}/usage/events

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

Query Parameters

page?number

Página a consultar (predeterminado: 1)

limit?integer

Cantidad de eventos por página (predeterminado: 50, máximo: 100)

Range1 <= value <= 100
from?string

Inicio del rango en formato ISO 8601, inclusive (ej: "2026-05-01T00:00:00Z")

to?string

Fin del rango en formato ISO 8601, EXCLUSIVE (ej: "2026-06-01T00:00:00Z"). Un evento con timestamp exactamente igual a to no entra en el rango: así un evento en el límite de facturación pertenece a un solo período, nunca a dos.

Response Body

application/json

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/events"
{
  "data": [
    {
      "created_at": "string",
      "customer_id": "string",
      "event_timestamp": "string",
      "id": "string",
      "idempotency_key": "string",
      "meter_id": "string",
      "processed": true,
      "subscription_id": "string",
      "value": "string"
    }
  ],
  "limit": 0.1,
  "object": "list",
  "page": 0.1
}
{
  "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"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}

Consultar consumo de una suscripción GET

Devuelve el consumo acumulado del período de facturación actual, agrupado por medidor. Incluye el monto pendiente de facturar.

Ejecutar un cobro ahora (solo sandbox) POST

Ejecuta de inmediato un cobro programado de tu sandbox, sin esperar a su `charge_date`. Si el cobro usa `retry_policy: automatic` y está esperando su próximo reintento, ejecuta ese reintento ahora. Cada llamada ejecuta como máximo un intento, así que puedes recorrer todo el ciclo de reintentos hasta el resultado final. No mueve el reloj de tu organización ni afecta otros cobros. El resultado llega igual que en producción: por los webhooks de cobro, con `livemode: false`. La respuesta es el cobro tal como quedó al despacharlo, normalmente todavía `processing`. Solo funciona con una clave de prueba (`pvtk_`). Con una clave de producción la llamada se rechaza y no se ejecuta nada.