---
title: "Create a monitored area"
method: POST
path: "/api/v1/monitoring"
---

# Create a monitored area

`POST /api/v1/monitoring`

## Request

- Base URL: `https://offnadir-delta.com`
- URL: `https://offnadir-delta.com/api/v1/monitoring`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Free to create. Fixes a bounding box and a quantity to measure; every new acquisition over it is measured automatically from then on. Each automatic check costs 2 tokens plus 0.5 per new scene measured, and a check that finds no new acquisition costs nothing. The area must be under 5,000 km² and the sensor is chosen from the metric. Requires the monitoring plan feature; area count is plan-gated and a 403 says which limit you hit.

## Request body

- object
  - `bbox` number[], required: Area to measure, [minLon, minLat, maxLon, maxLat] (WGS84). Must be under 5,000 km².
  - `metric` string, required: What to count. Plain words work (ships, fires, vegetation, water, burn, snow, built_up, moisture, night_lights) as do index names (ship_detection, fire_count, ndvi, evi, savi, ndmi, ndwi, mndwi, ndbi, ndsi, nbr, dnb, vv, vh, rvi, rfdi, cr).
  - `name` string: Label for the area.
  - `satellite` string: The sensor to measure with, chosen the way the app’s monitoring form does it (satellite × metric) — e.g. ship detection on Sentinel-1 or on NISAR. Omit for the metric’s first sensor (ship detection: Sentinel-1).
  - `start_date` string, date: YYYY-MM-DD to begin the history from (default 3 months ago, as in the app). A longer backfill measures more scenes and costs more on the first check.

## Response `201`

The created area, and how it will be metered.

- object
  - `area` object
  - `metering` object

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403`: Your plan does not include monitoring, or you are at the area limit.
- `429` (unresolved $ref)

---

[API](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api.md) · [All operations](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/revisions/5cf3f2bed5a2?raw)