DEV Community

Roman Kotenko
Roman Kotenko

Posted on • Originally published at road511.com

Fuel Price API for Fleet Cost Planning

#api #trucking #go #webdev

Fleet fuel costs are the second-largest operating expense after labor. Having state-level fuel price data in the same API as your truck routes, bridge clearances, and corridor restrictions means you can estimate total route costs in one integration.

Road511 now serves weekly US state-level and monthly Canadian province-level fuel prices from government sources.

The Sources

US — EIA (Energy Information Administration)

  • Weekly retail prices for all 50 states
  • Regular, midgrade, premium gasoline + diesel
  • USD per gallon
  • Updated every Monday

Canada — Statistics Canada

  • Monthly retail prices for 12 provinces/territories
  • Regular, premium gasoline + diesel
  • CAD cents per litre
  • Updated monthly

Both are official government data, free, and unrestricted.

Get Latest Prices 

curl "https://api.road511.com/api/v1/fuel-prices?country=US&fuel_type=diesel&latest=true" \
  -H "X-API-Key: your_key"
Enter fullscreen mode Exit fullscreen mode 
{
  "data": [
    {
      "jurisdiction": "CA",
      "country": "US",
      "fuel_type": "diesel",
      "price": 4.892,
      "currency": "USD",
      "unit": "gallon",
      "period_date": "2026-04-07",
      "frequency": "weekly",
      "source": "eia"
    },
    {
      "jurisdiction": "TX",
      "country": "US",
      "fuel_type": "diesel",
      "price": 3.241,
      "currency": "USD",
      "unit": "gallon",
      "period_date": "2026-04-07",
      "frequency": "weekly",
      "source": "eia"
    }
  ],
  "total": 50,
  "has_more": false
}
Enter fullscreen mode Exit fullscreen mode

Historical Trends

Track how prices change over time:

curl "https://api.road511.com/api/v1/fuel-prices?jurisdiction=CA&fuel_type=diesel&from=2025-01-01&to=2026-04-10" \
  -H "X-API-Key: your_key"
Enter fullscreen mode Exit fullscreen mode

Returns every weekly data point for California diesel over the past 15 months.

Cross-Border Queries

Get both US and Canadian prices in one response:

curl "https://api.road511.com/api/v1/fuel-prices?fuel_type=diesel&latest=true&limit=100" \
  -H "X-API-Key: your_key"
Enter fullscreen mode Exit fullscreen mode

Note: US prices are in USD/gallon, Canadian in CAD cents/litre. Convert as needed for your application.

Combine with Corridor Data

The real value is combining fuel prices with Road511's other data:

  1. Plan the route — check bridge clearances and weight restrictions via /truck/corridor
  2. Estimate fuel cost — get diesel prices for each state the route crosses via /fuel-prices
  3. Check conditions — verify road conditions and active incidents via /events

All from one API, one key, one integration.

Use Cases

  • Fleet fuel budgeting — forecast costs based on state-level price trends
  • Route cost optimization — factor fuel price differences into route selection
  • Rate calculations — logistics platforms adjusting freight rates by fuel cost
  • Analytics — correlate fuel prices with traffic patterns, delivery frequency

Try It

Top comments (0)