Credits & Pricing
Understand the credit system and billing.
Cargobloom uses a monthly credit system. Each API request costs a fixed number of credits based on the endpoint used.
Credit Costs
| Endpoint | Credits | Overage Price |
|---|---|---|
POST /benchmark/basic | 1 credit | €0.03 |
POST /benchmark/detailed | 2 credits | €0.12 |
GET /market | 1 credit | €0.03 |
Pricing Tiers
| Tier | API Access | Monthly Credits | Price | Overage |
|---|---|---|---|---|
| Free | No | — | Free | — |
| Standard | Yes | 200 credits | €30/month | Pay-as-you-go |
| Pro | Yes | 1,000 credits | €100/month | Pay-as-you-go |
| Enterprise | Yes | Unlimited | Custom | N/A |
API Access
The Free tier does not include API access. You must upgrade to Standard, Pro, or Enterprise to create API keys and use the API.
Annual Discount
Pay annually and save ~17%:
- Standard: €300/year (instead of €360)
- Pro: €1,000/year (instead of €1,200)
How Credits Work
Monthly Reset
Credits reset on the 1st of each month (or on your billing anniversary for paid plans).
Example:
- You have Pro tier (1,000 credits/month)
- On January 1st, you have 1,000 credits
- By January 15th, you've used 800 credits (200 remaining)
- On February 1st, credits reset to 1,000Unused credits do not roll over.
Checking Your Balance
View your remaining credits in the Developer Console under the Usage tab.
The response headers also include your remaining balance:
X-Credits-Remaining: 156
X-Credits-Limit: 1000Pay-as-You-Go (Overage)
Standard and Pro tiers. When your monthly credits run out, you can enable pay-as-you-go to continue making requests.
Enabling Overage
- Go to Developer Console
- Find the Pay-as-you-go toggle
- Turn it on
Billing Notice
When pay-as-you-go is enabled, you'll be automatically charged for usage beyond your monthly credits. Charges are billed to your payment method on file.
Overage Pricing
| Endpoint | Overage Price |
|---|---|
/benchmark/basic | €0.03 per request |
/benchmark/detailed | €0.12 per request |
/market | €0.03 per request |
What Happens When Credits Run Out
| Overage Setting | Behavior |
|---|---|
| Disabled (default) | API returns 402 CREDIT_LIMIT_EXCEEDED |
| Enabled | Request succeeds, billed as overage |
Error when credits exhausted and overage disabled:
{
"success": false,
"error": {
"code": "CREDIT_LIMIT_EXCEEDED",
"message": "Credit limit reached. Enable pay-as-you-go in Settings to continue."
}
}Free Tier
The Free tier provides access to the Cargobloom web dashboard but does not include API access.
To use the API, you must upgrade to Standard, Pro, or Enterprise.
Test Mode for Paid Users
Standard, Pro, and Enterprise users can create test keys (cb_test_*) that return mock data without consuming credits. Use them for development and testing.
Standard Tier
200 credits per month is great for getting started:
- ~200 basic benchmarks, or
- ~100 detailed benchmarks, or
- Any mix of endpoints
Standard Benefits
- API access
- Pay-as-you-go for usage spikes
- Usage analytics dashboard
Pro Tier
1,000 credits per month covers most use cases:
- ~1,000 basic benchmarks, or
- ~500 detailed benchmarks, or
- Any mix of endpoints
Pro Benefits
- Everything in Standard
- 5x more monthly credits
- Higher rate limits (configurable up to 50 req/s)
- Priority support
Enterprise Tier
For high-volume users (>10,000 requests/month):
- Unlimited credits (no overage fees)
- Custom rate limits
- Dedicated support
- SLA guarantees
- Custom data retention
Contact [email protected] for pricing.
Billing
Payment Methods
We accept:
- Credit/debit cards (Visa, Mastercard, Amex)
- SEPA direct debit (EU)
- Invoicing (Enterprise only)
Invoices
Invoices are generated monthly and available in your Subscription Settings.
Cancellation
You can cancel anytime. Your API access continues until the end of the current billing period. After cancellation, you'll retain access to the web dashboard but lose API access.
Cost Examples
| Use Case | Requests/Month | Plan | Est. Cost |
|---|---|---|---|
| Small integration | 100 basic | Standard | €30 |
| Rate auditing | 200 detailed | Standard | €30 (within limit) |
| Mid-size TMS | 500 basic | Pro | €100 |
| Large TMS | 1,000 detailed | Pro | €100 (within limit) |
| High-volume TMS | 2,000 basic | Pro + overage | €100 + €30 overage |
| Enterprise TMS | 50,000 basic | Enterprise | Custom |
Monitoring Usage
Dashboard
The Developer Console shows:
- Credits used vs. remaining
- Daily usage charts
- Cost breakdown by endpoint
- Request success/failure rates
FAQ
Do test keys consume credits?
No. Keys starting with cb_test_ return mock data and never consume credits.
What happens to unused credits?
Unused credits expire at the end of each billing period. They do not roll over.
Can I get a refund for unused credits?
No. Credits are use-it-or-lose-it within each billing period.
How do referral credits work?
Referral credits are bonus credits that don't expire and aren't reset monthly. Contact support for referral program details.
Last updated: February 3, 2026