Usage & Billing
Monitor your CTWise API usage and manage your subscription through the dashboard.
Viewing Usage
Navigate to Usage
- Log in to your dashboard
- Select CTWise from the product selector
- Click Usage in the navigation menu
Usage Dashboard
The usage dashboard shows:
| Metric | Description |
|---|---|
| API Calls This Period | Total calls in current billing period |
| Calls Remaining | Calls left before hitting tier limit |
| Daily Average | Average calls per day |
| Peak Usage | Highest usage day this period |
Usage Chart
The interactive chart displays:
- Daily API call volume
- Comparison to previous period
- Trend indicators
Understanding Your Tier Limits
API Call Limits
| Tier | Monthly API Calls | Overage Rate |
|---|---|---|
| Free | 1,000 | N/A (blocked) |
| Starter | 10,000 | $0.01/call |
| Pro | 50,000 | $0.008/call |
| Enterprise | Unlimited | N/A |
Rate Limits
| Tier | Requests/Second |
|---|---|
| Free | 2 |
| Starter | 10 |
| Pro | 50 |
| Enterprise | 100 |
Usage Alerts
The dashboard shows warnings when:
- You've used 80% of your monthly quota
- You've used 90% of your monthly quota
- You're approaching rate limits
Billing Information
AWS Marketplace Billing
All CTWise charges appear on your AWS bill:
- Subscription Fee: Monthly tier cost
- Overage Charges: If you exceed tier limits (Starter/Pro)
Viewing Bills
To view your detailed billing:
- Go to AWS Billing Console
- Navigate to Bills
- Find AWS Marketplace charges
- Look for CTWise line items
Billing Cycle
- Bills are generated monthly
- Usage is metered hourly
- Charges appear on your AWS bill within 48 hours
Subscription Management
Current Subscription
View your current subscription details:
| Field | Description |
|---|---|
| Tier | Your current pricing tier |
| Status | Active, Pending, or Cancelled |
| Start Date | When subscription began |
| Renewal Date | Next billing date |
Upgrading Your Tier
To upgrade your subscription:
- Go to AWS Marketplace Console
- Find your CTWise subscription
- Click Manage Subscription
- Select a higher tier
- Confirm the change
Upgrades take effect immediately. You're billed the prorated difference for the remaining period.
Downgrading Your Tier
To downgrade:
- Go to AWS Marketplace Console
- Find your CTWise subscription
- Click Manage Subscription
- Select a lower tier
- Confirm the change
Downgrades take effect at the start of the next billing period.
Cancelling Subscription
To cancel:
- Go to AWS Marketplace Console
- Find your CTWise subscription
- Click Cancel Subscription
- Confirm cancellation
After cancellation:
- Access continues until the end of the billing period
- API keys are deactivated at period end
- Data is retained for 30 days
Usage Reports
Export Usage Data
Download usage data for analysis:
- Navigate to Usage
- Click Export
- Select date range
- Choose format (CSV or JSON)
- Click Download
Report Contents
| Field | Description |
|---|---|
date | Date of usage |
endpoint | API endpoint called |
calls | Number of calls |
errors | Number of errors |
avg_latency_ms | Average response time |
Example CSV
date,endpoint,calls,errors,avg_latency_ms
2026-01-22,/v1/search,1234,12,145
2026-01-22,/v1/semantic-search,567,3,289
2026-01-23,/v1/search,1456,8,138
Cost Optimization
Tips to Reduce Costs
- Cache responses - Cache frequently accessed data
- Batch requests - Combine multiple queries when possible
- Use filters - Filter by source to reduce result processing
- Monitor usage - Set up alerts before hitting limits
Choosing the Right Tier
| If you need... | Recommended Tier |
|---|---|
| < 1,000 calls/month | Free |
| 1,000 - 10,000 calls/month | Starter |
| 10,000 - 50,000 calls/month | Pro |
| > 50,000 calls/month | Enterprise |
Troubleshooting
Usage Not Updating
Usage metrics update hourly. If you don't see recent calls:
- Wait up to 1 hour for metrics to refresh
- Check the timestamp on the dashboard
- Verify calls are being made with a valid API key
Unexpected Charges
If you see unexpected charges:
- Review the usage export for the period
- Check for unauthorized API key usage
- Verify no API keys were compromised
- Contact support if issues persist
Rate Limit Errors
If you're hitting rate limits frequently:
- Implement request queuing
- Add exponential backoff
- Consider upgrading your tier
- Optimize request patterns