> ## Documentation Index
> Fetch the complete documentation index at: https://idle.docs.datacircle.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Balance and credits

> Your balance, adding funds, the credits Datacircle gives, and the order they are spent in.

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

```bash theme={null}
curl https://idle.api.datacircle.dev/balance/ -H "Authorization: Token $DATACIRCLE_API_KEY"
```

```json theme={null}
{
  "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. The launch campaign gives a \$20 credit, usable for 24 hours, to every workspace created since the campaign opened, on its first `GET /balance/` or provider call in launch week (the 7 days after launch; the 24 hours start then; `GET /files/` and `/me/` calls don't start them), while the launch budget of \$1,000 lasts. It is listed in `temporary_credits` with its `expires_at`; whatever is left then is gone.
* **Manual:** added to your workspace by Datacircle by hand (a refund, a gift, a deal), permanent.

Every field is explained in the API reference: Datacircle, 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.

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

```json theme={null}
{ "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`), new every day, for the foreseeable future (see [Files](/files)). Credits never count toward it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.