# Storage price estimates

Estimate the monthly cost of storing a quantity of data with the JSON endpoint below. The
estimate is calculated live from the store's pay-as-you-go (PayG) pricing for the North Europe
archive region, so agents can price large backups before running them.

## How to call it

```
GET https://www.archivst.com/agentic/estimate-price?quantity=2&unit=Tb
```

| Parameter   | Required | Accepted values | Default | Description |
| --- | --- | --- | --- | --- |
| `quantity` | yes | positive number | — | Amount of data to store |
| `unit` | no | `Tb`, `Gb` | `Tb` | Unit for `quantity` (`Tb` = 1,000 Gb) |
| `currency` | no | `gbp`, `usd`, `eur` | `gbp` | Currency for the returned costs |

Example:

```
GET https://www.archivst.com/agentic/estimate-price?quantity=500&unit=Gb&currency=eur
```

## Response

```json
{
  "endpoint": "/agentic/estimate-price",
  "currency": "GBP",
  "symbol": "£",
  "quantity": 2,
  "unit": "Tb",
  "totalGb": 2000,
  "monthlyCost": 41.2,
  "yearlyCost": 494.4,
  "perGbMonthly": 0.0206,
  "retrieval": {
	"note": "One-off cost to retrieve all stored data (PayG plan, North Europe region)",
	"total": 105.0
  },
  "note": "Estimate based on the PayG pay-as-you-go plan and North Europe archive storage rates. Excludes taxes."
}
```

- `monthlyCost` is the recurring price per month for storing `quantity` of data.
- `yearlyCost` is `monthlyCost` times 12.
- `retrieval.total` is a **one-off** retrieval cost, not a monthly charge.
- Values are numeric — parse them rather than scraping formatted strings.

## Errors

| Status | Meaning |
| --- | --- |
| `400` | `quantity`, `unit`, or `currency` is missing or invalid |
| `500` | pricing data or currency conversion is unavailable |

Errors use the same JSON shape:

```json
{ "error": "Query parameter 'quantity' is required and must be a positive number." }
```

## How the estimate is calculated

1. Convert the quantity to gigabytes (`Tb` = 1,000 Gb).
2. Multiply by the archive storage rate for the North Europe region.
3. Add the PayG margin percentage.
4. The result is the monthly cost; retrieval uses the region's restore rate plus its own margin.

These figures mirror the [store pricing page](/prices); use them for budgeting, not invoicing.

[Back to Agentic Usage](/agentic)