Balance and credits - Datacircle

Your balance is what your workspace can spend, in dollars. Every call spends it at the provider’s price, no markup (Pricing). It holds two things: the funds you add, and the credits Datacircle gives you.

curl https://api.datacircle.dev/balance/ -H "Authorization: Token $DATACIRCLE_API_KEY"

{
  "balance_usd": 5.0,
  "signup_credit_usd": 5.0,
  "funds_usd": 0.0,
  "manual_credit_usd": 0.0,
  "temporary_credits": []
}

Credits

Signup: a $5 credit, permanent, once per workspace.
Temporary: from a campaign, usable until its expires_at and listed in temporary_credits. We remove what’s left of it then.
Manual: added to your workspace by Datacircle by hand (a refund, a gift, a deal), permanent.

Every field is explained in the API reference: Read the balance.

Spend order

Each call spends temporary credits first (soonest to expire), then the signup credit, then your funds and manual credits (oldest first). So credits never sit unused while you pay.

Adding funds

Add any whole number of dollars from $5 to $10,000 from your dashboard, or from the API: it returns a Stripe payment page to open or hand to a human.

curl -X POST https://api.datacircle.dev/checkout/ -H "Authorization: Token $DATACIRCLE_API_KEY" \
  -H "Content-Type: application/json" -d '{"amount_usd": 50}'

{ "checkout_url": "https://checkout.stripe.com/c/pay/..." }

The funds land in your balance as soon as Stripe confirms the payment, and never expire. A workspace that has added $50 in funds (in total) unlocks the co-op files (coop_up2data, coop_harvestapi, coop_fetchin), new every day, for the foreseeable future (see Files). Credits never count toward it.