API Reference

Usage & Credits

Check credit balances, per-project usage, transaction history, plan and subscription.

Last updated:

Usage, Credits & Subscription API

Inspect credit balances, plan limits, active subscription, and the credit transaction ledger for the authenticated user.

Summary

GET /api/v1/usage/summary

Returns current credits, infrastructure usage, active plan, billing period, and the credits consumed during the current period.

Per-project Usage

GET /api/v1/usage/projects

Transaction Ledger

GET /api/v1/usage/transactions?page=1&limit=50&type=refinement

Paginated list of credit debits and credits. Optionaltype filter limits the result to one transaction type.

Current Plan

GET /api/v1/user/plan

Current Subscription

GET /api/v1/subscriptions/current

Safe fields only — Stripe customer and subscription IDs are never exposed through the public API.