Meterd

Meterd Documentation

Meterd is a production-grade usage metering platform for SaaS applications. It tracks every event your customers generate, aggregates usage in real time, and provides the data you need for billing, quota enforcement, and analytics. Meterd exposes both a REST API and a gRPC API so you can integrate from any language or framework.

What Meterd does

  • Ingest events — Send raw usage events via REST or gRPC. Meterd handles validation, deduplication, and rate limiting.
  • Aggregate in real time — Define meters that transform raw events into usage metrics using sum, count, unique count, max, last, average, or percentile aggregations.
  • Query usage — Retrieve aggregated usage data by customer, meter, and time range with flexible granularity.
  • Product catalog — Manage applications, environments, features, and plans with per-plan quota limits.
  • Enforce quotas — Real-time quota checks with low latency. Two-phase commit support for complex workflows.
  • Trigger webhooks — Get notified when customers exceed thresholds or usage anomalies are detected.
  • Sync to billing — Push metered usage to Stripe for automated usage-based billing.

Architecture overview

Meterd is a fully hosted, multi-tenant platform with complete data isolation between organizations. The REST API is available at https://api.meterd.io, and a gRPC API is also available for high-throughput integrations. All data is scoped to tenants — each tenant has its own meters, customers, events, and API keys with no cross-tenant data access. The API is rate-limited to 1,000 requests per minute per tenant; responses include X-RateLimit-Limit and X-RateLimit-Remaining headers so your application can adapt.

Next steps

  • Quickstart — Get Meterd running and send your first event in 5 minutes
  • Authentication — Learn about API keys, HMAC signatures, and internal auth
  • Concepts — Understand meters, aggregations, windows, and quotas
  • API Reference — Full endpoint documentation