Credits, top-ups and plans
The credit unit, balances, credit packs in US dollars, auto-reload, expiry, trial credits and plans.
Everything on Arettic is paid in credits. 1 credit = $0.001, and prices are whole credits. Money in the API is always { "credits": "7", "usd": "0.007" }. An org holds the credits; its agents spend them, within their budgets. A purchase is charged only when its result passes the pass rule.
Balance
GET https://api.arettic.com/v1/balancewith an agent key:org_balance(paid,trial,total) and the agent'sagent_spent_month,agent_budgetandagent_budget_left. Over MCP:get_balance.GET https://api.arettic.com/v1/orgs/{orgId}/balancefor a member or an org key: the org'spaid,trialandtotal.- Trial credits are always spent before paid ones. A purchase that needs more than the total is declined with
402 insufficient_credits.
Top-ups
POST https://api.arettic.com/v1/orgs/{orgId}/topups with amount_usd (a pack: 10, 50, 100, 500) and optionally save_card: true, or the Billing page of the dashboard, where the card form opens on the page. The answer has a checkout_url to pay at; the credits land when the payment clears. Once a card is saved, use_saved_card: true charges it straight away instead: no checkout, checkout_url is null, and a declined card answers 402 card_declined.
| Rule | Value |
|---|---|
| Packs | $10 (10,000 credits), $50 (50,000 credits), $100 (100,000 credits), $500 (500,000 credits) |
| New orgs, first 14 days | at most $200 in total |
| Currency | US dollars |
| Tax | Included in every price |
| Receipts | Every paid top-up gets one: GET /v1/orgs/{orgId}/topups has its invoice_url. |
curl https://api.arettic.com/v1/orgs/$ORG_ID/topups \ -H "Authorization: Bearer $ARETTIC_ORG_KEY" \ -H "Content-Type: application/json" \ -d '{ "amount_usd": 50, "save_card": true }'
Auto-reload
Save a card with a top-up (save_card: true), then PUT https://api.arettic.com/v1/orgs/{orgId}/auto-reload with enabled, threshold_usd (at least $1) and amount_usd (a pack: 10, 50, 100, 500). Every 5 minutes, an org whose paid credits are under the threshold is charged for the pack, tax included, at most once every 10 minutes. A declined charge is tried again after an hour, then after 6 hours: 3 tries in all. After the third, or at once when the card can't be charged again (lost, stolen, expired, closed), auto-reload turns off and the owners get an email. GET /v1/orgs/{orgId}/auto-reload shows failed_tries and next_try_at.
Expiry
- Paid credits expire 12 months after the top-up that bought them. Spending is oldest-first, so only credits you haven't used in a year expire. Owners get an email 30 days before.
- Trial credits expire 30 days after they're granted; a
trial.expiringevent comes 7 days before.
Trial credits
- $1 when you make your org. No phone or card needed. One per company domain (or per address, for free email).
- $10 more when you have a demo call with us.
- Until an org's first top-up, it can spend at most 50 trial credits an hour (
429 trial_limit).
Low-balance alert
PUT https://api.arettic.com/v1/orgs/{orgId}/notifications with low_balance_usd (default $5). When the balance falls under it, the owners get an email and webhooks get balance.low, once per top-up. See webhooks.
What a result costs
Each task has one price per passed result for each plan, whichever tool does the work; a few premium tools that cost much more to run keep their own. A failed check costs nothing. Prices are recomputed daily as providers change theirs; a move over 20% is reviewed by a person first, and orgs that used the tool get price.changed. Every tool's price is on /prices and at GET https://api.arettic.com/v1/pricing; the price that applies is in each answer before you're charged.
Plans
| Plan | Price | Price per result | Seats | Requests a minute, all agents | Score lookups a day | Free-text lookups a day |
|---|---|---|---|---|---|---|
| Pay as you go | $0 + credits | Listed price | no limit | 1,200 | 10,000 | 250 |
| Pro | $149 a month or $1,490 a year (two months free) | 10% less | no limit | 3,000 | 25,000 | 500 |
| Scale | $499 a month or $4,990 a year (two months free) | 13% less | no limit | 6,000 | 50,000 | 2,500 |
| Max | Custom: contact us | Custom | no limit | 12,000 | no limit | no limit |
Agents are unlimited on every plan. Start Pro with POST https://api.arettic.com/v1/orgs/{orgId}/subscriptions and { "plan": "team", "interval": "month" } (or "year"), or Scale with "plan": "scale"; the answer has a checkout link. Move between Pro and Scale, or between monthly and yearly, with POST /v1/orgs/{orgId}/subscriptions/change and the same body: it takes effect at once and the difference for the rest of the period is charged or credited. GET /v1/orgs/{orgId}/plan shows the plan and what it includes; DELETE /v1/orgs/{orgId}/subscriptions/{plan} cancels at the end of the period. Pro includes 180,000 credits a month, including 31,000 free, and Scale 600,000, including 101,000 free; unused monthly plan credits roll over one month. Yearly is two months free ($1,490 for Pro, $4,990 for Scale) and gets all twelve months of credits up front, valid for 12 months, with no rollover. All prices include sales tax. Plan credits are spent before top-up credits. Max is by contract and paid by bank transfer: you get a numbered invoice (the plan fee for the period and any prepaid credits) by email and under Invoices, with the bank details and a due date; credits on it are added when the transfer arrives.
Frozen credits
Rarely, while we look into something on an account (a chargeback, a card flagged by the payment provider), we freeze its credits. Purchases are then declined with 403 credits_frozen; sign-in, reads, receipts and exports keep working. Email support and we'll tell you what's needed.
Credits stay on Arettic
Credits are for buying results on Arettic. They can't be cashed out, sold, or moved to another org.