Skip to main content

Usage & quotas

Read current credit balances and per-meter usage to build quota dashboards and warnings.

Read usage and quotas#

Pull current credit balances and per-meter usage.

Usage is exposed per-org as a JSON document with one entry per meter (storage, queries, research credits). Each meter reports `used`, `limit`, and `pct`. Build your own quota-warning UI by polling this endpoint; the dashboard shows the same data live.

// GET /v1/orgs/:orgId/usage
const res = await fetch(
  `https://api.meetdewey.com/v1/orgs/${orgId}/usage`,
  { headers: { Authorization: `Bearer ${process.env.DEWEY_API_KEY}` } },
)
const usage = await res.json()

for (const [meter, m] of Object.entries(usage.meters)) {
  const limit = (m as any).limit
  const pct = limit ? Math.round(((m as any).used / limit) * 100) : 0
  console.log(`${meter}: ${(m as any).used}/${limit ?? '∞'} (${pct}%)`)
}

Response

{
  "orgId": "org_xyz",
  "tier": "pro",
  "meters": {
    "storage":         { "used": 18472331, "limit": 5368709120, "unit": "bytes" },
    "queries":         { "used": 412, "limit": 10000 },
    "researchCredits": { "used": 38,  "limit": 200 }
  }
}

See also