Skip to main content
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.
The time range selector applies to the chart, the model table and the spend summary.

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 the usage: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).
Response Format:
On a Plan sold in usage credit, 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:
  1. Navigate: app.promptguard.co → Billing → Usage
  2. Check Usage: See requests used vs. monthly limit
  3. 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
  4. Upgrade: Upgrade your plan if you need higher base limits
You are also warned as you approach the limit, by email and in the dashboard: see Reaching your limit.

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

Common Causes:
  • Requests not properly authenticated
  • API key belongs to different project
  • Data outside retention period
Solutions:
  • 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
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
Need help with usage tracking setup? Contact support for assistance with analytics and reporting.
Last modified on November 13, 2026