---
title: "Get AOI Monitor"
method: GET
path: "/earthcache/aoi-monitors/{monitor_id}"
tags: ["aoiMonitors"]
---

# Get AOI Monitor

`GET /earthcache/aoi-monitors/{monitor_id}`

Returns the details of a single AOI monitor by its ID.

## Response `200`

AOI monitor found.

- AOIMonitor — An AOI monitor tracking satellite imagery over a geographic region.
  - `id` string, uuid, required — Unique monitor identifier.
  - `name` string, required — Display name for the monitor.
  - `description` string, nullable — Optional description.
  - `location` AOIMonitorLocation, required — GeoJSON Polygon representing the area of interest.
    - `type` 'Polygon', required — Must be "Polygon".
    - `coordinates` array[], required — Array of linear rings. The first ring is the exterior boundary.
      - array[]
        - number[] — [longitude, latitude] or [longitude, latitude, elevation]
    - `bbox` number[] — Optional bounding box [minLon, minLat, maxLon, maxLat].
  - `run_mode` 'auto' | 'manual', required — "auto" runs the monitor on a recurring schedule; "manual" requires explicit triggering.
  - `start_date` string, date, required — Start of the monitoring period (ISO 8601 date).
  - `end_date` string, date, required — End of the monitoring period (ISO 8601 date).
  - `last_run_time` string, date-time, nullable — Timestamp of the last monitor run.
  - `max_cloud_cover` number, nullable — Maximum acceptable cloud cover percentage (0–100).
  - `min_aoi_coverage` number, nullable — Minimum required AOI coverage percentage (0–100).
  - `notify_users` string[], nullable — User IDs to notify when new imagery is found. MUA accounts only.
  - `sources` string[], nullable — Satellite data sources to monitor.
  - `min_resolution` number, nullable — Minimum resolution filter in meters per pixel.
  - `max_resolution` number, nullable — Maximum resolution filter in meters per pixel.
  - `off_nadir_angle` number[], nullable — [min, max] off-nadir angle range in degrees. The first value must be less than the second.
  - `project_id` string, nullable — Associated project ID. MUA accounts only.
  - `org_id` string, nullable — Organization identifier.
  - `user_id` string, required — ID of the user who created the monitor.
  - `sensor_type` string[], nullable — Sensor type filter.
  - `origin` string, nullable — Origin identifier for the monitor.
  - `created_at` string, date-time, nullable — Creation timestamp (ISO 8601).
  - `updated_at` string, date-time, nullable — Last update timestamp (ISO 8601).

## Other responses

- `401` — Unauthorized
- `404` — Monitor not found or does not belong to the authenticated organization.
- `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)