GET /v1/usage

Inspect your current plan, monthly quota, credit balance, and concurrency state.

Endpoint

http

GET https://api.buildonto.dev/v1/usage
Authorization: Bearer onto_sk_...

Response

json

{
  "tier": "starter",

  "monthly_limit": 10000,
  "used_this_month": 1342,
  "remaining": 8658,
  "overage_allowed": true,
  "reset_at": "2026-06-01T00:00:00.000Z",

  "concurrent_limit": 5,
  "in_flight": 0,
  "concurrent_remaining": 5,

  "credits": {
    "balance": 2200,
    "recent_transactions": [
      { "id": "...", "delta": 2200, "reason": "purchase", "balance_after": 2200, "created_at": "..." }
    ]
  }
}

Example

tierstringoptionalfree | starter | growth | scale | enterprise

monthly_limitintoptionalPlan request cap per UTC month.

used_this_monthintoptionalPlan counter (excludes credit-debited overage).

overage_allowedbooleanoptionalWhether your tier can fall through to credits at the cap. Free is always false.

concurrent_limitintoptionalMax in-flight requests for your tier.

in_flightintoptionalCurrent in-flight count (resets via 30s TTL safety net).

credits.balanceintoptionalCredits remaining. Drains 1 per request once over the monthly cap.

credits.recent_transactionsarrayoptionalLast 5 credit movements: purchases, usage debits, grants, adjustments.

bash

curl -H "Authorization: Bearer $ONTO_API_KEY" \
  https://api.buildonto.dev/v1/usage | jq