---
title: "Calculate cost of area and intervals"
method: POST
path: "/price/calculate"
tags: ["pricing"]
---

# Calculate cost of area and intervals

`POST /price/calculate`

Calculate cost of specified location and intervals, taking purchase minimums and prepurchase discounts into account

## Request body

- PriceCalculatorRequest
  - `resolution` 'low' | 'medium' | 'high' | 'very_high', required — Resolution of data to be purchased
  - `location` union, required
    - Polygon
      - `type` 'Polygon', required
      - `coordinates` array[], required
        - array[]
          - number[]
      - `bbox` number[]
    - object
      - `ref` object, required
        - `uri` string, uri, required
  - `start_date` string, date — Start date of your collection period
  - `end_date` string, date — End date of your collection period
  - `interval` string — Interval of each collection, in days
  - `tasking` boolean — Is purchase for a tasking request?
  - `source` string — Source of data to be purchased

## Response `200`

Success

- PriceCalculatorResponse
  - `data` object, required
    - `plan` 'test' | 'build' | 'scale' — Name of plan requestor is on
    - `resolution` 'low' | 'medium' | 'high' | 'very_high' — Resolution of data to be purchased
    - `source` string — Source of data to be purchased
    - `area_km2` number — Quantity of data to be purchased in square kilometers
    - `archive` object — Price and costing information for archive data
      - `price_km2` number — Price of specified resolution in USD per square kilometer
      - `minimum_area_km2` number — Minimum area that will be billed for requested resolution, in square kilometers
      - `discount_price_km2` number — Discounted price of specified resolution in USD per square kilometer
      - `interval_quantity` number — Number of intervals requiring archive data
      - `interval_cost` number — Cost in USD of archive data for one interval to be purchased at requested resolution. Price includes discounts and minimum purchase requirements
      - `max_cost` number — Maximum cost in USD of archive data for all intervals to be purchased at requested resolution. Price includes discounts and minimum purchase requirements
    - `tasking` object — Price and costing information for tasking data
      - `price_km2` number — Price of specified resolution in USD per square kilometer
      - `minimum_area_km2` number — Minimum area that will be billed for requested resolution, in square kilometers
      - `discount_price_km2` number — Discounted price of specified resolution in USD per square kilometer
      - `interval_quantity` number — Number of intervals requiring tasking data
      - `interval_cost` number — Cost in USD of tasking data for one interval to be purchased at requested resolution. Price includes discounts and minimum purchase requirements
      - `max_cost` number — Maximum cost in USD of tasking data for all intervals to be purchased at requested resolution. Price includes discounts and minimum purchase requirements
    - `max_cost` number — Maximum cost in USD of all archive and tasking data to be purchased at requested resolution. Price includes discounts and minimum purchase requirements
    - `prepurchase_balance` number — Balance in USD of prepurchase amount remaining at the end of the last invoice period

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/skywatch/apis/api-specification.md) · [All operations](https://skmtc.net/skywatch/apis/api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skywatch/api-specification/revisions/51f7c5a8d15d/schema)
