Venflow API
V1Cobro basado en usoMedidores

Listar todos los medidores

GET
/v1/usage/meters

Authorization

Api-Key<token>

Tu clave API privada (comienza con pvk_)

In: header

Organization<token>

Tu ID de organización

In: header

Query Parameters

limit?integer

Límite de resultados (1–100, predeterminado: 10)

Range1 <= value <= 100
starting_after?string

Cursor de paginación — ID del último objeto visto

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.venflow.app/v1/usage/meters"
{
  "data": [
    {
      "active": true,
      "aggregation_method": "sum",
      "created": 0.1,
      "event_name": "string",
      "id": "string",
      "livemode": true,
      "name": "string",
      "object": "meter",
      "unit_label": "string"
    }
  ],
  "has_more": true,
  "object": "list",
  "url": "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"
}

Registrar un evento de uso POST

Registra un evento de consumo para una suscripción activa. Los eventos se agregan por medidor al final del período de facturación y se incluyen en el invoice de renovación. Usá `idempotency_key` para evitar duplicados: si enviás el mismo valor dos veces, el segundo evento es ignorado sin error.

Crear un medidor POST

Crea un nuevo medidor de uso para tu organización. Los medidores rastrean eventos de consumo y los agregan para la facturación. El `event_name` debe ser único por organización.