v4

latestOpenAPI 3.1.0Proprietary2026-08-034715226.2 KB
fuel-prices

Regional fuel prices

Returns regional fuel prices. Weekly US state-level (EIA) and monthly Canadian province-level (StatCan). Use latest=true to get only the most recent observation per jurisdiction + fuel_type. 24-hour cache (data refreshes daily at the source).

get/fuel-prices

Query parameters

jurisdictionstring

Filter by jurisdiction code (e.g., GA, ON, CA). Required on Free plan.

Auto-expansion: querying a state's primary code that has WZDx/CWZ or sub-state regional siblings (see GET /jurisdictions/groups) is expanded transparently to include all members. For example, ?jurisdiction=CA returns rows from CA, WZDX_CA, and 511SF.

To opt out, query a non-primary code directly (?jurisdiction=WZDX_CA returns WZDx-only rows) or pass a comma-separated list explicitly (?jurisdiction=CA,WZDX_CA), which bypasses expansion and matches each code literally.

country'US' | 'CA'

Filter by country

fuel_type'regular' | 'midgrade' | 'premium' | 'diesel'

Filter by fuel grade

fromstring date

Start date (YYYY-MM-DD)

tostring date

End date (YYYY-MM-DD)

latestboolean

Return only the most recent observation per jurisdiction + fuel_type

limitinteger

Results per page (capped by plan)

offsetinteger

Pagination offset

Response

Paginated fuel prices