Sign up
All data sources

IEA Release API

Licence required

Find and download the IEA data products your organization licenses, by product and release.

Set up this sourceGet the full contract and schemas as JSONConnect this source →

Requires an IEA Enterprise or Global Enterprise licence and your IEA Release API token. Connecting it is included on Free.

Questions you can ask

  • “Which IEA products does our licence include?”
  • “What is the latest release of our oil market product?”
  • “Download the data file from that release.”
Sample outputfor “Which IEA products does our licence include?”
ProductLatest releaseFiles
Example balances product2026-074
Example monthly statistics2026-092
Example outlook tables2026-066

Illustrative values showing the shape of an answer, not live data.

About this source

Official licensed IEA Release API. The model directly chooses among six exact read-only operations: product listing, release listing/details/latest, and file download by IDs or by exact release date and filename. The runtime only validates bounded arguments, places the Bearer token, enforces the official fixed paths, and caps provider responses.

Connector ID iea

Provenance

PublisherInternational Energy Agency (IEA)
Sourcehttps://www.iea.org/data-and-statistics
API basehttps://www.iea.org/api
Docshttps://www.iea.org/documentation

Freshness & coverage

FreshnessScheduled — Freshness follows each licensed IEA product release cadence.
GeographicGlobal energy products and releases available under the licensed account
TemporalNot declared
AuthenticationCredentials required (Bearer token)

Caveats

  • ⚠ Requires an IEA Enterprise or Global Enterprise licence Bearer token.
  • ⚠ All six provider operations use POST but are read-only metadata lookups or downloads.
  • ⚠ The former undocumented api.iea.org/stats convenience methods are intentionally not exposed here because connector authentication is connector-level and their coverage overlaps the EIA connector.

› Methods (6)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • listProducts

    read

    List IEA Release API products available under the licensed account.

    EntitiesIEA product
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST with an empty body, but read-only. Provider result fields remain product-defined.

  • listReleases

    read

    List releases for one exact IEA product.

    Required paramsproductId
    EntitiesIEA release
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST with an empty body, but read-only. Provider result fields remain product-defined.

  • getRelease

    read

    Get one exact release for an IEA product.

    Required paramsproductIdreleaseId
    EntitiesIEA release
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST with an empty body, but read-only. Provider result fields remain product-defined.

  • getLatestRelease

    read

    Get the latest release for one exact IEA product.

    Required paramsproductId
    EntitiesIEA release
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST with an empty body, but read-only. Provider result fields remain product-defined.

  • downloadFileByIds

    read

    Download one IEA release file by exact product, release, and file IDs.

    Required paramsproductIdreleaseIdfileId
    EntitiesIEA release file
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST but read-only. Download bytes are hard-capped and never cached.

  • downloadFileByName

    read

    Download one IEA release file by exact product ID, release date, and filename.

    Required paramsproductIdreleaseDatefilename
    EntitiesIEA release file
    Paginationnone
    FreshnessScheduled (source-level)
    • ⚠ HTTP POST but read-only. Download bytes are hard-capped and never cached.