# Credits and billing (/billing)

Verify is paid for with prepaid credits. There are no plans, seats or minimums, and every new account starts with free credits. Rates for each endpoint are on the [pricing page](https://fieldgeist.com/pricing).

## What's billed [#whats-billed]

**Every answered request is billed; errors and refused requests are free.** Concretely, a request is billed when the API answers with HTTP `200`:

| Answer | Billed |
| --- | --- |
| Parse `200`, including a parse with warnings or an empty line | Yes |
| Lookup `200` with any status: `matched`, `matched_building`, `ambiguous`, `no_situs_parcel`, `not_found` | Yes |
| Lookup by ID `200` (`active` or `superseded`) | Yes |
| Lookup by ID `404 not_found` | No |
| Any `4xx` or `5xx` error, including `402` and `403` refusals | No |

Requests from the portal's **Verify** page (the Playground) are billed the same way as API requests.

To spend less per address, store the `fieldgeist_id` from a lookup and refresh the parcel later with [Look up by ID](/api-reference/lookup-by-id), which costs less than a new lookup.

## Credits [#credits]

- **One balance per team.** Everyone on a team draws from the same credits. Owners and Admins manage billing.
- **Add credits by card** in the portal's **Billing** page, $5 to $5,000 at a time. Payments are processed by Stripe.
- **Credits don't expire** while your team exists. Purchased credits aren't refundable except as the [refund policy](https://fieldgeist.com/terms#refunds) describes.
- **The sign-up credits** are given once per person.

## Auto recharge [#auto-recharge]

Optional. When the balance falls below a threshold you set, the team's saved card is charged the amount you set. The threshold is at least $5, and the amount is at least the threshold and at most $5,000. If a charge is declined, auto recharge pauses until you update the card.

## Budgets and alerts [#budgets-and-alerts]

- **Monthly budget:** caps a calendar month's spend (UTC). When the month's spend reaches it, requests are refused with `402 budget_exceeded` until you raise or remove it.
- **Spend alert:** an email to the team's Owners and Admins when the month's spend reaches an amount you choose, below the budget.

## When the balance runs out [#when-the-balance-runs-out]

At zero, requests are refused with `402 insufficient_credit` instead of running up a balance. Add credits and they resume within minutes. Refused requests show in **Logs** and aren't billed.

## Track spend [#track-spend]

- **Usage** shows requests and spend by hour and day, kept for 13 months.
- **Logs** shows each request for 30 days, with its status, outcome and request ID.
- **Billing** shows the balance, payments and the month's spend.