Skip to main content
GET
ListCountryHeadlines

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

country_codes
string[]
required

ISO 3166-1 alpha-2 codes. Repeated query parameter, at most 250 countries.

Required array length: 1 - 250 elements
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

ListCountryHeadlinesResponse describes cache availability independently of country matches.

countries
object

Requested country codes with matching headlines; absent countries had no match.

state
string

complete | partial | unavailable. A failed revocation read is unavailable.

feedTotal
integer<int32>

Configured full-variant feeds reachable from the English digest.

feedCached
integer<int32>

Feeds whose parsed cache was available, including cached empty feeds.

readAt
string

Time the caches were read; article freshness is determined by published_at.