Skip to main content
GET
GetOilStocksAnalysis

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

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

GetOilStocksAnalysisResponse contains the IEA oil stocks days-of-cover analysis.

updatedAt
string

UTC ISO-8601 timestamp when this analysis was written.

dataMonth
string

Data month in YYYY-MM format (source: IEA monthly release).

ieaMembers
object[]
belowObligation
string[]

ISO2 codes of countries currently below the 90-day obligation.

regionalSummary
object

OilStocksRegionalSummary holds regional aggregates for the three IEA regions.

unavailable
boolean

True when upstream seed data is unavailable (fallback result). True when the upstream or seed-backed variant is unavailable; empty payload fields are graceful degradation, not confirmed zero data.