Usage
Monitor your ParseSphere usage to understand consumption and optimize your plan.
Accessing Usage
Go to Usage in your dashboard to see your consumption metrics.
Credit Summary
At the top of the page, the Credit Summary card shows your current plan at a glance:
- Remaining / Included — How many credits you have left out of your plan allowance
- Used — Credits consumed this billing period
- Usage % — Visual progress bar of plan consumption
- Reset date — When your credit allowance resets
If pay-as-you-go is enabled, you'll also see your PAYG balance, purchased credits, and the per-credit rate.
Expand Breakdown by category to see credits split across four categories: Docs, Chat, Tables, and API.
Usage Charts
Usage Trend — A stacked area chart showing daily credit consumption by category. Toggle between 7D, 14D, and 30D views.
Distribution — A donut chart showing the proportion of credits consumed by each category, with the total in the center.
Detailed Metrics
Expand Detailed Metrics at the bottom of the page to see document processing statistics:
- Documents extracted — Total count with success/failure breakdown
- Pages processed — Total pages across all documents
- Avg pages per document — Based on completed extractions
- Extraction success rate — Percentage with failure count
Usage History
The Usage History table logs every credit-consuming event. Each row shows:
| Column | Description |
|---|---|
| Event | Event and subscription identifiers |
| Type | Badge showing Parse, Chat, Document, or Tabular |
| Tokens | Input and output token counts (chat events only) |
| Credits | Credits consumed by this event |
| Date | When the event occurred |
Filter by event type: All, Documents, Chat, or API. The table paginates at 10 events per page and refreshes automatically every 5 minutes.
Understanding Credits
ParseSphere uses a credit system. Your plan includes a monthly credit allowance that resets each billing cycle. See Billing for plan details.
| Action | Credits |
|---|---|
| Parse page with OCR | 1 credit per page |
| Parse page without OCR | 1 credit per 4 pages |
| Document upload (workspace) | 1 credit per page |
| Tabular file upload (workspace) | 1 credit per file |
| Chat message | Based on tokens (1 credit per ~2,000 input tokens, 1 credit per ~400 output tokens) |
Chat credits benefit from caching—when the AI reuses context from earlier in your conversation, cached tokens cost up to 90% less.
Usage Alerts
Information
Usage alerts are coming soon! You'll be able to set notifications when you reach certain thresholds.
Optimizing Usage
Reduce Parse Usage
- Enable OCR only when needed (scanned documents)
- Disable table extraction if you don't need tables
- Use shorter session TTLs for one-off parses
Reduce Chat Usage
- Ask specific questions (reduces token usage)
- Use follow-ups instead of repeating context
- Filter to specific datasets when possible