Skip to main content
GET
GetNo2Activity

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

country_code
string

ISO 3166-1 alpha-2: the country plus its clusters.

Pattern: ^([A-Za-z]{2})?$
region_id
string

Registry id, e.g. "yangtze-river-delta".

Pattern: ^([a-z0-9-]{1,64})?$
kind
enum<string>

Countries, clusters, or both when unspecified.

Available options:
NO2_REGION_KIND_COUNTRY,
NO2_REGION_KIND_CLUSTER
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

regions
object[]
generatedAt
string
stale
boolean

Older than the 72 h health budget.

methodVersion
string

Pins the method constants in scripts/shared/no2-activity.mjs.

attribution
string

Required Copernicus credit line.

unavailableReason
enum<string>

NOT_COVERED is a contract answer; the rest are faults.

Available options:
NO2_ACTIVITY_UNAVAILABLE_REASON_UNSPECIFIED,
NO2_ACTIVITY_UNAVAILABLE_REASON_INVALID_REQUEST,
NO2_ACTIVITY_UNAVAILABLE_REASON_NOT_COVERED,
NO2_ACTIVITY_UNAVAILABLE_REASON_SEED_MISSING,
NO2_ACTIVITY_UNAVAILABLE_REASON_INVALID_DATASET,
NO2_ACTIVITY_UNAVAILABLE_REASON_CACHE_UNAVAILABLE
upstreamUnavailable
boolean

False when served or not covered.