Skip to main content
GET
GetWatchedSiteImagery

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

site_id
string
required

Watched-site id from the registry, ":", e.g. "port:jebel_ali". Never a coordinate.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

GetWatchedSiteImageryResponse is the public imagery summary of one watched site: its newest image and next pass. It carries no change flag, coverage or pass history; those stay on the Pro surfaces.

siteId
string
name
string
lat
number<double>

The registry's site coordinates, which are public; never a user's point.

lon
number<double>
evaluatedAt
integer<int64>

When the site was last evaluated, as Unix epoch milliseconds; 0 when it has no record.. Warning: Values > 2^53 may lose precision in JavaScript

stale
boolean

True when the record is missing or older than its freshness limit; latest_image and next_pass are then absent.

latestImage
object

SiteImage is the newest archive scene of a watched site.

nextPass
object

SitePass is the next pass expected to image a watched site.