Billing & credits

cloro uses a subscription-based billing model with monthly credit allocations and concurrency limits based on your plan tier.

​

Subscription plans

Find our plan options, concurrency levels and pricing at cloro.dev. All plans include:

• Access to all API endpoints
• Response headers with credit and concurrency tracking
• Dashboard access for usage monitoring and billing management

​

Free tier

Every account starts on the free tier — 500 credits, refreshed at the start of each month — with 1 concurrent request and access to all endpoints and providers. Complete onboarding actions to earn recurring bonus credits on top each month: leave a G2 review (+500/mo), add a backlink (+500/mo), and introduce yourself in the r/cloroapi welcome thread (+200/mo). Each bonus persists only while the underlying action stays live. No card is required, so it’s the way to evaluate the API and cover light, ongoing use. When you need more, subscribe to a paid plan from the dashboard: Lite ($30/mo) is the entry tier, and Hobby, Starter, Growth, and Business scale up credits and concurrency (and lower the per-credit rate) from there. See the pricing page for current numbers. Free-tier accounts are single-seat, and every paid plan includes unlimited team members — see Team members.

​

How billing works

cloro bills only for successful requests: credits are deducted when a request completes successfully (success: true), and failed requests cost zero, so retries are free. The exception is a request you cancel client-side, which is charged for work already done (see Error handling).

​

Credit allocation

• Credits are allocated at the start of each billing cycle
• Credit consumption varies by endpoint and features used (see Providers)
• Sync monitor requests include a +2 credit surcharge (see Providers for details)
• For batch requests, credits are tracked per task — each task’s result carries its own creditsToCharge and creditsCharged values
• Each response returns the amount charged and your remaining balance in the X-Credits-Charged and X-Credits-Remaining headers

​

Credit expiration

Important: Credits expire at the end of each billing cycle and do not roll over to the next month. If you have unused credits at the end of your billing cycle, they will be lost. Plan your usage to make the most of your subscription.

​

Billing cycles

• All plans operate on monthly billing cycles
• Billing cycles start on the date you subscribe and renew on the same date each month
• Renewals are automatic unless you cancel

​

Managing your subscription

All subscription management is handled through the dashboard:

• Upgrade plans: Switch to higher-volume tiers with immediate effect. When upgrading, we prorate the price for the remaining days and set your available balance to the full new plan allocation minus credits already consumed this cycle — unused credits from the old plan are preserved, not reset.
• Downgrade plans: Downgrades take effect at the start of your next billing cycle — your current plan continues until cycle end, then the lower plan activates. No proration charge.
• Monitor usage: View credit balance, usage graphs, and billing history
• Cancel subscription: Service continues until the end of the current billing cycle, but no refunds are issued for unused credits.

​

Update billing details and access invoices

To change your payment method, update your billing address or tax ID, or download past invoices:

1. Go to the dashboard and open Billing from the left sidebar.
2. In the Current plan card, click Manage your billing.
3. The customer portal opens, where you can:
   • Update your payment method
   • Edit your billing address, company name, and tax ID
   • View and download invoices and receipts
   • Update the email address invoices are sent to

Changes made in the customer portal apply to future invoices.

​

Closing your account

Cancelling stops future charges but keeps your account. To delete your organization or your user account instead, see Account & organizations — deleting the organization also cancels the subscription.

​

Standard vs. enterprise plans

​

Standard plans

Standard plans (Lite, Hobby, Starter, Growth, Business) are available through the dashboard with immediate activation. For higher monthly volumes or annual-contract terms, see Enterprise plans below. The pricing page has current tier counts, credit allocations, and concurrency limits.

• Self-service: Subscribe and upgrade directly through the dashboard
• No overage charges: Service stops when you run out of credits
• Flexible: Upgrade anytime and cancel at the end of the billing cycle
• Immediate access: Start using the API right away

​

Enterprise plans

Enterprise comes in two forms:

• Self-serve monthly tiers — subscribed through the dashboard, billed like Standard plans: hard credit cap, no overages, cancel anytime.
• Annual contracts — 12-month commitments, available from the entry Enterprise tier upward and required above the self-serve ceiling. In the overlap band the choice is yours. See the pricing page for the current ceiling and tier details.

Annual contract benefits (self-serve monthly tiers get the baseline allocation at the same dollar amount with none of these):

• Overages allowed: service continues after your monthly credit allocation is exhausted; overage credits are billed at your contracted per-credit rate in the following billing cycle
• 20% more credits per month (17% lower effective per-credit rate vs. the equivalent self-serve monthly tier)
• 1.3× concurrency: your concurrent-request limit is boosted vs. the baseline for the same dollar tier
• Access to non-public endpoints: available on request, subject to cloro’s discretion
• Price lock for the 12-month term: fees and per-credit rate are fixed for the contract duration
• Net 7-day payment: pay by bank transfer or ACH direct debit

Getting started with enterprise: At or above the entry Enterprise tier an annual contract is worth considering; above the self-serve ceiling it is the only route, and subscribing requires sales. Contact our sales team and you’ll be sent the contract for signature. Upon receiving the signed contract, your Enterprise plan will be configured in less than 24 hours.

​

Common questions

​

Do unused credits roll over to the next month?

No — see credit expiration.

​

How can I check my current credit balance?

Programmatically, call GET /v1/credits — it returns your current balance (remaining), credits per cycle (perCycle), and the cycle reset date (cycleResetsAt). This works for async-only workloads too, so you don’t need to make a billable sync request just to read your balance. Every sync monitor response also returns the balance in the X-Credits-Remaining header. In the dashboard you can see:

• Current credit balance
• Usage for the current billing cycle
• Projected spend based on current usage
• Historical usage data

​

What happens when I run out of credits?

When you reach your credit limit, your API requests will be rejected with a 403 Insufficient Credits error. Async tasks you already queued are affected too — they are re-checked when the scheduler reaches them and move to FAILED rather than waiting for a top-up. See what happens to async tasks when your credits run out. To continue using the API:

1. Switch to a higher-tier monthly plan (takes effect immediately)
2. Wait for the next billing cycle (credits replenish on your renewal date)
3. Contact sales for an annual Enterprise contract — annual plans include overages, so service continues at your contracted rate instead of stopping at the cap

Whenever you hit 80% and 100% of your monthly allocation you will be informed via email.

​

What does the free tier include, and can free-tier users contact support?

The free tier gives you 500 credits refreshed each month — plus recurring bonus credits for onboarding actions you complete — so you can evaluate the API and run light workloads before subscribing. Free-tier accounts are capped at 1 concurrent request (see Rate & concurrency limits) but otherwise have access to all endpoints and providers. Free-tier support is self-serve: ask the docs AI assistant with the Ask Assistant button on any docs page. Paid plans get direct support through the in-dashboard chat widget. For volume, concurrency, or annual-contract questions, email info@cloro.dev or see Enterprise plans.

​

Is there a pay-as-you-go option?

No. cloro uses a credit-based subscription model — there is no pay-as-you-go or per-request pricing. All plans include a fixed monthly credit allocation, and credits not used by the end of the cycle expire and do not roll over. If you want a low-commitment start, the free tier covers evaluation and the Lite plan ($30/mo) is the cheapest subscription.

​

Are credits charged when shopping cards or ads fields return empty?

Yes. Credits are deducted whenever a response returns "success": true, regardless of whether optional fields like shoppingCards, ads, or sources contain data. These fields are opportunity-based: cloro attempts to extract them when the AI surface serves that content. An empty shoppingCards: [] is a valid result, not a failure. Use success: false to identify requests that should not be charged.

​

Do I need a VAT registration to sign up?

No. You can start on the free tier or subscribe to any plan without a VAT number — VAT is charged on the invoice where applicable. Once you have a VAT number, add it under Billing → Manage your billing in the dashboard and it will appear on future invoices.

​

Can I see request history beyond the current billing cycle?

The credit usage log in the dashboard supports a custom date range picker.

​

Can I get a refund if I cancel my subscription?

No refunds are issued when you cancel your subscription. When you cancel:

• Service continues until the end of the current billing cycle
• You retain access to all remaining credits during that period
• No charges occur for subsequent billing cycles