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

# Pricing

> What a task costs, when it is charged, and when it is refunded.

A task costs **\$0.013**, on every model, with every enrichment included. A test key is free.

## Prepaid balance

Your organization pays from a prepaid balance in USD:

* **Trial.** The first card you add gives a \$1.00 credit, once per organization. Nothing is charged on the card.
* **Top-ups.** Top up in the dashboard, under **Billing**. A top-up is \$5 or more. Each top-up gets an invoice.

Read the balance with [`GET /v1/balance`](https://docs.apiforgeo.com/api-reference/get-the-balance):

```json theme={null}
{ "currency": "USD", "balanceMicros": 4987000, "alertState": "ok" }
```

## Charges and refunds

* A task is charged **when it is created**. The price is in `costMicros` on the task.
* A task that **fails** is refunded in full. The task then has `refunded: true`.
* A balance too low for a task refuses it: `402` with the code `insufficient_balance`. Nothing is charged.

## Amounts are micro-dollars

Every amount is an integer of micro-dollars: 1 USD = 1,000,000.

| Value | Dollars |
| - | - |
| `costMicros: 13000` | \$0.013 |
| `balanceMicros: 4987000` | \$4.987 |
| `spendMicros: 1300000` | \$1.30 |

Integers keep sums exact. Divide by 1,000,000 only to show a value.

## Low balance alerts

`alertState` is `ok`, `low` or `depleted`:

* `low`: the balance is under your organization's threshold. Set it in the dashboard.
* `depleted`: the balance cannot pay for one more task.

When the state changes, the owners and admins get an email, and your webhook endpoints get `balance.low` or `balance.depleted`. See [Webhooks](https://docs.apiforgeo.com/concepts/webhooks.md).

## Control the spend

* Give each key a total or monthly budget. See [Budgets](https://docs.apiforgeo.com/authentication.md#budgets).
* Read the spend by day, model and key with [`GET /v1/usage`](https://docs.apiforgeo.com/api-reference/get-usage). It counts live tasks only.

```bash theme={null}
curl "https://api.apiforgeo.com/v1/usage?from=2026-11-01&to=2026-11-19" \
  -H "Authorization: Bearer $AFG_API_KEY"
```


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