> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataville.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Plans and credits
> Check what a request costs and how far your monthly credits go.
Every Dataville plan includes a monthly grant of credits, in USD. Requests deduct their cost from that balance, and the balance resets to your plan's grant at the start of each billing period. Credits you don't use in a period do not carry over.
## Choosing a plan
Every plan includes every data source, exports, SQL queries, connected sheets, and the MCP server. Pro has lower per-request rates.
| Plan | Price | Monthly credits |
| - | - | - |
| Free | \$0 per month | \$5 |
| Developer | \$29 per month | \$29 |
| Pro | \$99 per month | \$99 |
You can change or cancel your plan at any time on the [Billing](https://app.dataville.com/billing) page. Changes take effect immediately: your balance is set to the new plan's monthly grant and a new billing period starts. Unused time on a paid plan is credited toward your next invoice. Canceling moves you to the Free plan.
## Paying for requests
Each request deducts a per-request rate from your balance. The rate depends on the source and your plan: Wikipedia is a premium source and costs more than the rest of the catalog, which shares a single standard rate. You can see the rate for every source on the [Data Library](https://app.dataville.com/datasets) page.
| Source | Free | Developer | Pro |
| - | - | - | - |
| Wikipedia | \$0.0250 | \$0.0150 | \$0.0125 |
| All other sources | \$0.0050 | \$0.0050 | \$0.0040 |
What counts as one request depends on the endpoint:
* A data lookup, a search from the MCP server, and an export download each count as one request at the source's rate. See [Search a data source](/api-reference/data-sources/search-a-data-source) and [Download one source as CSV or Parquet](/api-reference/export-and-sql/download-one-source-as-csv-or-parquet). Fetching a Wikipedia article by URL is charged at the Wikipedia rate. See [Fetch an article by pasting its URL](/api-reference/data-sources/fetch-an-article-by-pasting-its-url).
* Whole-catalog downloads ([`dataville.db`](/api-reference/export-and-sql/download-every-dataset-as-a-duckdb-database), [`dataville.csv.zip`](/api-reference/export-and-sql/download-every-dataset-as-a-zip-of-csvs), and [`dataville.parquet.zip`](/api-reference/export-and-sql/download-every-dataset-as-a-zip-of-parquet-files)) count as one standard-rate request.
* [SQL queries](/api-reference/export-and-sql/run-a-sql-select-across-the-datasets) through `POST /api/v1/query` are charged one standard-rate request per row returned, whatever source the rows come from. A query that returns 1,000 rows costs the same as 1,000 lookups, so use `LIMIT`.
* Connected-sheet [queries](/api-reference/connected-sheets/run-sql-against-one-connected-sheet) and [searches](/api-reference/connected-sheets/keyword-search-a-connected-sheet) are not charged.
You are only charged for successful responses that return data. Errors are not charged, and a download that fails before it completes is refunded.
## Checking your balance
The [Billing](https://app.dataville.com/billing) page shows your remaining credit and when it resets, your top-off balance, and usage broken down by source.
You can also check your balance from the API. Every charged response includes `X-Credit-Cost` and `X-Credits-Remaining` headers, in USD, and a `usage` object in the body.
## Buying more credits
You can buy credits on the [Billing](https://app.dataville.com/billing) page in any amount from \$5 to \$500. Top-off credits never expire. You keep them if you change plans, and Dataville uses them only once your monthly credits run out.
### Auto-reload
Turn on **Auto-reload** to buy the same top-off automatically whenever your balance drops below an amount you set. Auto-reload needs a saved card and runs at most once an hour.
## Running out of credits
When your balance cannot cover a request's full cost, the API returns **402** with `error: insufficient_credit` and charges nothing. The body includes your remaining balance and the cost of the request. See [Insufficient credit](/api-reference/errors#insufficient-credit-402).
To keep going, buy credits, upgrade your plan, or wait for your monthly reset.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.