Skip to main content

Documentation Index

Fetch the complete documentation index at: https://guide.withvayu.com/llms.txt

Use this file to discover all available pages before exploring further.

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.