Skip to main content
GET
GetCountrySignalObservations

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

country_code
string
required

Uppercase ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$
family
enum<string>
required

Fixed source family or eligible flight page; unspecified is rejected.

Available options:
COUNTRY_SIGNAL_FAMILY_OUTAGES,
COUNTRY_SIGNAL_FAMILY_UNREST,
COUNTRY_SIGNAL_FAMILY_FIRES,
COUNTRY_SIGNAL_FAMILY_RADIATION,
COUNTRY_SIGNAL_FAMILY_SANCTIONS,
COUNTRY_SIGNAL_FAMILY_CONFLICT,
COUNTRY_SIGNAL_FAMILY_POSTURE,
COUNTRY_SIGNAL_FAMILY_FLIGHT_PAGE
window_index
integer<int32>

Country-derived flight viewport index, 0 or 1. Other families require 0.

Required range: 0 <= x <= 1
cursor
string

Prior eligible flight page cursor. Other families require an empty cursor.

Maximum string length: 200
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

Nullable clocks and coverage live in the validated bounded outcome JSON. Flight pages retain the original typed provider-attributed flight DTO.

countryCode
string
family
enum<string>

Fixed country observation profiles; callers cannot select sources or viewports.

Available options:
COUNTRY_SIGNAL_FAMILY_UNSPECIFIED,
COUNTRY_SIGNAL_FAMILY_OUTAGES,
COUNTRY_SIGNAL_FAMILY_UNREST,
COUNTRY_SIGNAL_FAMILY_FIRES,
COUNTRY_SIGNAL_FAMILY_RADIATION,
COUNTRY_SIGNAL_FAMILY_SANCTIONS,
COUNTRY_SIGNAL_FAMILY_CONFLICT,
COUNTRY_SIGNAL_FAMILY_POSTURE,
COUNTRY_SIGNAL_FAMILY_FLIGHT_PAGE
outcomeJson
string
flightPage
object

ListMilitaryFlightsResponse contains military flights and clusters.

windowIndex
integer<int32>