EIA energy inventories

One weekly EIA series: level and weekly change.

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/energy/inventories

EIA petroleum and gas inventories. Reads stored data only and needs a key on an account with a plan; every plan reads every live dataset in full. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

  • Credits: 1 (lookup x1)
  • Plans: Basic, Desk, Enterprise

Example response

Synthetic values, marked in meta. GET /v1/datasets/energy-inventories/sample returns it with no key and no account.

json
{
  "data": {
    "source": "EIA",
    "generatedAt": "2026-09-30T12:00:00.000Z",
    "status": "partial",
    "gaps": [
      "ILLUSTRATIVE sample only"
    ],
    "reports": [
      {
        "id": "petroleum",
        "weekEnding": "2026-09-25",
        "releasedAt": null,
        "releaseHoliday": null,
        "nextWeekEnding": null,
        "nextReleaseAt": null,
        "nextReleaseHoliday": null
      }
    ],
    "series": [
      {
        "id": "crude-commercial",
        "key": "WCESTUS1",
        "report": "petroleum",
        "tab": "crude",
        "label": "Commercial crude oil",
        "unit": "kb",
        "weekEnding": "2026-09-25",
        "value": 100,
        "previousWeekEnding": "2026-09-18",
        "weekChange": 1,
        "yearAgo": null,
        "fiveYear": null,
        "read": null,
        "seasonal": null
      },
      {
        "id": "gasoline",
        "key": "WGTSTUS1",
        "report": "petroleum",
        "tab": "products",
        "label": "Motor gasoline",
        "unit": "kb",
        "weekEnding": "2026-09-25",
        "value": 200,
        "previousWeekEnding": "2026-09-18",
        "weekChange": 2,
        "yearAgo": null,
        "fiveYear": null,
        "read": null,
        "seasonal": null
      },
      {
        "id": "distillate",
        "key": "WDISTUS1",
        "report": "petroleum",
        "tab": "products",
        "label": "Distillate fuel oil",
        "unit": "kb",
        "weekEnding": "2026-09-25",
        "value": 300,
        "previousWeekEnding": "2026-09-18",
        "weekChange": 3,
        "yearAgo": null,
        "fiveYear": null,
        "read": null,
        "seasonal": null
      }
    ]
  },
  "meta": {
    "dataset": "energy-inventories",
    "asOf": null,
    "source": [
      {
        "id": "eia-inventories",
        "attribution": "U.S. Energy Information Administration",
        "licence": "Public domain"
      }
    ],
    "historyStarts": null,
    "coverage": null,
    "lastUpdated": null,
    "sample": true,
    "note": "ILLUSTRATIVE: synthetic examples showing the response fields; not real company disclosures or published observations."
  }
}

Meta fields

Field

dataset

Here

The dataset id

In the example

"energy-inventories"

Field

asOf

Here

The newest weekEnding across reports

In the example

null

Field

source

Here

Attribution and licence of each source

In the example

1 source

Field

historyStarts

Here

Earliest stored history when established by the service; otherwise null.

In the example

null, not stated yet

Field

coverage

Here

Service-established coverage; null when unavailable.

In the example

null

Field

lastUpdated

Here

null: the service exposes no read time

In the example

null

Sources

Source

U.S. Energy Information Administration

Licence

Public domain

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.