Amberflo

Amberflo provides the infrastructure for usage-based billing: ingest metered usage events (API calls, compute minutes, tokens processed), aggregate them by customer and meter, apply pricing rules, and generate invoices. For agents automating billing operations: ingest usage events as services consume resources, query real-time usage aggregates per customer, trigger invoice generation, and manage pricing plan configurations via API. Strong fit for AI API businesses and SaaS platforms shifting to consumption-based pricing. Competitive with Metronome (enterprise) and Lago (open-source). Confidence is docs-derived.

REST API at api.amberflo.io. Resources: ingest (usage events), meter-aggregates, customers, pricing-plans, invoices. POST /ingest ingests usage events ({customerId, meterApiName, meterValue, dimensions: {key: value}, utc: timestamp}). GET /meter-aggregates/batch retrieves aggregated usage per customer/meter for a time window. POST /customers creates or updates a customer record. GET /invoices/{id} retrieves an invoice. POST /payment-invoice triggers invoice generation. Batch ingestion: POST /ingest/batch for high-throughput event streams. Response: JSON.

API key auth: X-API-KEY: {api_key} header. Keys from Amberflo Console → Settings → API Keys. Workspace-scoped keys. HTTPS enforced. No OAuth2. Separate keys for ingestion (write) and query (read) recommended for least-privilege. Rate limiting: plan-based (ingestion throughput and query rate limits). Key rotation via Amberflo Console.

Standard HTTP status codes with JSON error bodies. 401 for invalid API key, 429 for rate limit (Retry-After header), 400 for malformed event payload. Ingest endpoint: fire-and-forget with acknowledgment (events queued for processing); retry safe (idempotency via event ID). Aggregate query: real-time (latest events within seconds). Invoice generation: async (poll invoice status). Amberflo service uptime at status.amberflo.io.

docs.amberflo.io provides API reference for ingest, aggregates, customer management, and invoice operations. Getting started: create account (free trial), generate API key, first event ingestion in under 5 minutes. SDKs: Python (amberflo-client), Node.js (amberflo-client-js), Go, Java. Real-time usage dashboard in Amberflo Console. Support via Amberflo Slack community and support email.