KwitKwit Docs

Usage billing API

Meters, events ingest, and meter management

llms.txtMeters, events ingest, and meter management

Ingest usage events

POST /v1/events/ingest

Body (ingestUsageEventsSchema) - batch of events with customer, meter, quantity, and timestamp fields per schema.

Response 201 - ingest summary from UsageEventService.ingest.

List events

GET /v1/events

Query (listUsageEventsSchema): customerId, meterId, page, perPage.

Response 200 - paginated events.

Meters

MethodPathDescription
POST/metersCreate (createMeterSchema)
GET/metersList (active, search)
PATCH/meters/:idUpdate (updateMeterSchema)
DELETE/meters/:idRemove - 204 empty body
  • GET /v1/customers/:id/state - Customers API
  • POST /v1/customers/:id/meter-credits - grant credits
  • PATCH /v1/products/:id/meter-prices - Products API

Checkout links API

Reusable hosted checkout URLs

Errors

HTTP status codes and SDK error handling

On this page

Ingest usage eventsList eventsMetersRelated