GetDisplacementSummary
GetDisplacementSummary retrieves global refugee and IDP statistics from UNHCR. Empty/absent summary with fetched_at=0 or data_available=false means the snapshot is unavailable/degraded, not that global displacement is zero.
Authorizations
User-issued WorldMonitor API key.
Query Parameters
Data year to retrieve (e.g., 2023). Uses latest available if zero.
Maximum number of country entries to return.
Maximum number of displacement flows to return.
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
GetDisplacementSummaryResponse contains the global displacement summary.
DisplacementSummary represents a global overview of displacement data from UNHCR.
Time the seed or live fallback snapshot was fetched, as Unix epoch milliseconds. A value of 0 means the snapshot is unavailable/degraded, not that global displacement is zero.. Warning: Values > 2^53 may lose precision in JavaScript
True when summary came from a seed snapshot or live fallback. False means an absent/empty summary is graceful degradation because the snapshot is unavailable.
