Usage Dashboard
The usage dashboard shows detailed analytics about your API consumption, quota status, and usage trends.
Accessing Usage Data
Navigate to Developer → Usage in the sidebar. You can also see a quick summary on the main dashboard Overview page.
Quota Overview
The top of the page shows:
| Metric | Description |
|---|---|
| Queries Used | Total API queries consumed this billing period |
| Queries Remaining | How many queries you have left |
| Reset Date | When your quota resets (billing cycle date) |
| Usage Percentage | Visual progress bar |
Daily Breakdown
A line chart shows your daily API usage for the current billing period:
- X-axis — Days of the billing period
- Y-axis — Number of API queries
- Trend line — Average daily usage
- Projected — Dotted line showing projected usage based on current trend
Hover over any day to see the exact count.
Usage by Endpoint
A breakdown table shows which endpoints consume the most queries:
| Endpoint | Queries | % of Total |
|---|---|---|
/v1/enrichment/domain | 4,521 | 45.2% |
/v1/search/domains | 2,890 | 28.9% |
/v1/enrichment/bulk | 1,200 | 12.0% |
/v1/email-finder | 890 | 8.9% |
/v1/tech-stack | 499 | 5.0% |
This helps you understand where your quota is going and optimize if needed.
Usage by API Key
If you have multiple API keys, see which key is consuming the most:
| API Key | Name | Queries |
|---|---|---|
| cdb_...a1b2 | Production | 7,200 |
| cdb_...c3d4 | Staging | 1,800 |
| cdb_...e5f6 | Zapier | 1,000 |
Quota Alerts
CronDB sends automatic notifications at these thresholds:
| Threshold | Notification |
|---|---|
| 80% | Email warning: "You've used 80% of your monthly quota" |
| 95% | Email warning: "You're about to reach your limit" |
| 100% | Email alert: "Quota exhausted" (Free) or "Overage billing active" (Paid) |
Configure these alerts in Account → Settings → Notifications.
Overage Tracking
On paid plans, when you exceed your quota:
- A yellow banner appears in the dashboard
- The overage count is tracked separately
- Overage charges appear on your next invoice
| Plan | Per-Query Overage Rate |
|---|---|
| Starter | $0.01 |
| Pro | $0.005 |
| Enterprise | $0.002 |
Spending Cap
Set a maximum overage spend to prevent surprise charges:
- Go to Account → Billing → Spending Cap
- Enter a maximum dollar amount (e.g., $50)
- When the cap is reached, the API returns 429 errors until your next billing cycle
Exporting Usage Data
Click Export on the usage page to download your usage data as CSV:
date,endpoint,queries,api_key_name
2026-03-01,/v1/enrichment/domain,142,Production
2026-03-01,/v1/search/domains,89,Production
2026-03-02,/v1/enrichment/domain,167,Production
This is useful for internal reporting and cost allocation.
Historical Usage
Toggle between billing periods using the date selector at the top of the page. CronDB retains 12 months of usage history.
Next Steps
- Plans & Pricing — Compare plans and their quotas
- Upgrade Guide — Upgrade for higher quotas
- API Rate Limits — Understand rate limits vs. quotas