title: Metering

description: How Wontopos measures and meters your API usage.

Metering

Every API request is counted and metered in real time to track usage against your plan limits.

What counts as a request?

  • Any HTTP request to api.wontopos.com that receives a response (including errors)
  • Webhook deliveries do not count towards your request limit
  • Health check requests (GET /health) are excluded

Metering endpoints

GET /v1/usage
const usage = await client.usage.get({
  from: "2026-03-01",
  to: "2026-03-30",
});
console.log(`${usage.totalRequests} requests this month`);
GET /v1/usage/realtime
const realtime = await client.usage.realtime();
console.log(`${realtime.requestsToday} requests today`);
console.log(`${realtime.remainingToday} remaining`);

Usage dashboard

The dashboard at Settings > Usage provides:

  • Daily and monthly request volume charts
  • Breakdown by API subscription
  • Average latency and error rate
  • Projected usage for the current month

Usage alerts

Configure alerts at **Settings > Alerts** to get notified when you reach 80% or 100% of your daily limit. Alerts can be sent via email or webhook.

Usage alert webhook

{
  "type": "usage.limit_reached",
  "data": {
    "threshold": 0.8,
    "current_requests": 80000,
    "limit": 100000,
    "period": "daily"
  }
}