PromptGuard counts every request against your plan’s monthly allowance. You can read that count in the dashboard or from the API, alongside your PromptGuard spend for the billing cycle and the token volume of each model your requests used.
The Usage page
Open Billing (under Organization in the sidebar) and choose the Usage tab. It shows the Organization you are acting in:- Spend this cycle: Total this cycle (subscription plus on-demand), Included (your plan’s price) and On-demand (overage, against your spend cap if you set one). These are PromptGuard charges, not what your LLM providers bill you, and they are shown only to whoever answers for the Organization’s billing.
- Current Usage: requests used against the monthly limit, the percentage used and the requests remaining.
- Billing Period: days remaining in the cycle, and the month’s projected requests at the current daily rate, with a note when that projection is over your allowance.
- Daily Requests: a chart of requests per day. An Organization’s admins see the whole Organization’s traffic; everyone else sees their own requests in it.
- By Model: for each model, its provider, the number of requests, and tokens in, tokens out and total.
Elsewhere in the dashboard
- Overview shows request volume, requests scanned, detected and allowed, requests by threat type, and Top Sources: the share of requests from each country, by the client IP’s location.
- A project’s Analytics page (Developer and Enterprise) adds a Response Times chart of average latency over the selected range.
API Usage Tracking
Current Availability
Developer API - Usage Stats
Get current usage statistics via API. The key needs theusage:read scope
(Usage at Read under Restrict key when you create it): a key made
with the dashboard’s defaults holds scan and proxy only, and is refused
with 403 scope_denied (Get Usage Stats).
- Python
- Node.js
- cURL
credit_usd is the month’s credit at list
prices, credit_used_usd what your Requests have cost so far and
credit_remaining_usd what is left, and usage_percentage is the share of the
credit used. On a Plan with no credit they are null and 0.
The figures are those of the Plan that covers the key’s Organization, which is
the allowance the key’s requests are counted against. remaining never goes
below 0.
reset_date is when used_this_month next returns to 0. The allowance is
monthly on every plan, annual ones included, and each month runs from the
day it began: your subscription’s renewal day on a paid plan, the day you
signed up on Free. It is not the first of the calendar month.
Spending and billing
Under Billing, the Spending tab is where you set the spend cap for usage past your credit, and the Plan tab has your subscription. To cap what a project’s proxied requests cost at your LLM providers, set an upstream spend cap on the project.Rate Limiting and Quotas
Current Limits
Usage limits are based on your subscription plan:Monitoring Quotas
View your current usage in the dashboard:- Navigate: app.promptguard.co → Billing → Usage
- Check Usage: See requests used vs. monthly limit
- Spend cap: On Developer, usage past the credit is billed at list prices up to your spend cap; raise or lower it on Billing → Spending
- Upgrade: Upgrade your plan if you need higher base limits
Historical Data
Data Retention
Security events are kept for your plan’s log retention period: see the Log retention row of Plans & Limits. There is no separate retention period for aggregated data.Need longer retention periods? Contact sales@promptguard.co for enterprise solutions with custom retention policies.
Troubleshooting Usage Tracking
Missing Usage Data
Missing Usage Data
Common Causes:
- Requests not properly authenticated
- API key belongs to different project
- Data outside retention period
- Verify API key is correct and active
- Check that API key belongs to the project you’re querying
- Check request timestamps
- Contact support for data recovery
Incorrect Usage Counts
Incorrect Usage Counts
Solutions:
- Check which Organization you are acting in: the page shows that Organization’s allowance
- Check the time range selector
- Ensure the API key belongs to that Organization
- Refresh dashboard to get latest data
Next Steps
Dashboard Analytics
Explore the full monitoring dashboard
Interactions
View detailed security events and interactions
Plans & Limits
Review plan quotas, rate limits, and how usage is calculated
Billing
Manage your subscription and billing
Best Practices
Running PromptGuard in production