Skip to main content
GET /v1/usage returns API usage for the organization behind your key — useful for building your own dashboards, alerting on error spikes, or spotting a noisy route. Requires the emails scope. The response has three views:
  • overview — rolling 24h totals (requests, successRate 0–100, errors, rateLimited).
  • trend — 30 daily points (date, requests, errors).
  • routes — per-route rollup over the last 7 days (route, requests, successRate, topErrorCode).

​
Read usage

curl "https://brew.new/api/v1/usage" \
  -H "Authorization: Bearer $BREW_API_KEY"

​
Alert on degraded success rate

const { usage } = await brew.usage.get()
if (usage.overview.successRate < 95) {
  await pageOncall(`Brew API success rate dropped to ${usage.overview.successRate}%`)
}

​
See also

​
Need Help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

Search Documentation

Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.

ChatGPT/Claude Integration

Click “Open in ChatGPT” at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.