Vayu API

Overview

The Vayu API gives you programmatic access to your billing operations — create and manage customers, contracts, catalog products, events, invoices, credits, measurements, and webhooks. All resources are accessible via RESTful HTTP endpoints and are supported by official SDKs in TypeScript, Python, and Go.

Base URL: https://connect.withvayu.com

OpenAPI Spec: Download vy-openapi.yml

• Authentication — Get your credentials and make your first authenticated request
• SDKs — Official client libraries for TypeScript, Python, and Go
• Webhooks — Receive real-time event notifications

Key concepts

• Pagination — All list endpoints use cursor-based pagination. See Pagination.
• Idempotency — Events support an idempotency key via the ref field. See Idempotency.
• Batch ingestion — Send 1–1,000 events per request (256 KB max). See Sending Events.
• Error handling — All errors return structured JSON with a machine-readable code. See Errors.
• Rate limits — See Rate Limits.