Usage & Billing
Monitor your SanctionsWise API usage and manage your subscription through the dashboard.
Viewing Usage​
Navigate to Usage​
- Log in to your dashboard
- Select SanctionsWise from the product selector
- Click Usage in the navigation menu
Usage Dashboard​
The usage dashboard shows:
| Metric | Description |
|---|---|
| Screenings This Period | Total screenings in current billing period |
| Screenings Remaining | Screenings left before hitting tier limit |
| Daily Average | Average screenings per day |
| Peak Usage | Highest usage day this period |
Usage Chart​
The interactive chart displays:
- Daily screening volume
- Comparison to previous period
- Trend indicators
- Match rate statistics
Understanding Your Tier Limits​
Screening Limits​
| Tier | Monthly Screenings | Overage Rate |
|---|---|---|
| Free | 500 | N/A (blocked) |
| Starter | 5,000 | $0.02/screen |
| Professional | 25,000 | $0.015/screen |
| Enterprise | 100,000+ | Custom pricing |
Rate Limits​
| Tier | Requests/Second | Batch Size |
|---|---|---|
| Free | 1 | 10 |
| Starter | 5 | 25 |
| Professional | 25 | 50 |
| Enterprise | 50 | 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 SanctionsWise charges appear on your AWS bill:
- Subscription Fee: Monthly tier cost
- Overage Charges: If you exceed tier limits (Starter/Professional)
Viewing Bills​
To view your detailed billing:
- Go to AWS Billing Console
- Navigate to Bills
- Find AWS Marketplace charges
- Look for SanctionsWise 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 SanctionsWise 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 SanctionsWise 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 SanctionsWise subscription
- Click Cancel Subscription
- Confirm cancellation
After cancellation:
- Access continues until the end of the billing period
- API keys are deactivated at period end
- Screening data is retained for 30 days
Usage Reports​
Export Usage Data​
Download usage data for compliance and 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 |
screenings | Number of screenings |
matches | Number of matches found |
avg_latency_ms | Average response time |
Example CSV​
date,endpoint,screenings,matches,avg_latency_ms
2026-01-22,/v1/screen/entity,1234,23,145
2026-01-22,/v1/screen/batch,567,12,489
2026-01-23,/v1/screen/entity,1456,28,138
Compliance Reporting​
For compliance purposes, you can also export:
- Match history
- Entity details for matches
- Audit trail of screenings
Cost Optimization​
Tips to Reduce Costs​
- Cache clear results - Cache negative screening results for short periods
- Batch requests - Use batch screening for multiple entities
- Optimize thresholds - Adjust thresholds to reduce false positives
- Monitor usage - Set up alerts before hitting limits
Choosing the Right Tier​
| If you screen... | Recommended Tier |
|---|---|
| < 500 entities/month | Free |
| 500 - 5,000 entities/month | Starter |
| 5,000 - 25,000 entities/month | Professional |
| > 25,000 entities/month | Enterprise |
Batch Screening Efficiency​
Using batch screening is more efficient than individual calls:
| Method | 100 Entities | API Calls |
|---|---|---|
| Individual | 100 screens | 100 calls |
| Batch (25) | 100 screens | 4 calls |
| Batch (50) | 100 screens | 2 calls |
Troubleshooting​
Usage Not Updating​
Usage metrics update hourly. If you don't see recent screenings:
- Wait up to 1 hour for metrics to refresh
- Check the timestamp on the dashboard
- Verify screenings 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
- Use batch screening instead of individual calls
- Consider upgrading your tier