OilPriceAPI Docs
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
    • Batch Prices
    • Excel Latest Price Gateway
    • Price Widget Endpoints
    • Price Utility Endpoints
    • Natural Gas Intelligence
  • Commodities

    • List Commodities
    • Get Commodity Details
  • AI Agents (MCP)

    • Get Market Brief
    • Subscriptions / Watches
    • Agent Subscriptions with MCP
  • Marine Fuels

    • Marine Fuel API
    • List Marine Fuel Ports
    • Get Port Details with Prices
    • Bunker Fuels
    • Maritime Fuels
  • Fuel Surcharge (LTL)

    • Fuel Surcharge API (LTL Carriers)
    • List Fuel Surcharges
    • Latest Carrier Fuel Surcharge
    • Carrier Fuel Surcharge History
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
    • Benchmark Close
    • Aviation Fuel Pilot
  • Spreads & Margins

    • Spreads & Margins
    • Crack Spreads
    • Basis Spreads
    • Refining Margins
    • Curve Structure
    • Physical Premiums
  • Market Indicators

    • Market Indicators
    • Fuel Switching
    • Price Context
    • Storage Analytics
    • CFTC Positioning
    • Congressional Trades
    • Market Annotations
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
    • ICE EUA Carbon Futures
    • EU Carbon Futures
    • TTF Gas Futures
    • LNG JKM Futures
    • UK Carbon Futures
  • Dark Data (Premium)

    • Energy Intelligence API
    • Rig Counts
    • Well Permits
    • Well Production Beta
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Well Production (Beta)

    • Well Production Data
    • Well Production API Reference
  • Analytics

    • Analytics API
  • Webhooks API

    • Webhooks API Reference
    • Webhook Endpoint Reference
  • Alerts

    • Price Alerts API
  • Account & Billing

    • Account API
    • API Keys
    • Subscriptions
    • Organizations

Fuel Surcharge API (LTL Carriers)

Per-carrier fuel-surcharge data for major US less-than-truckload (LTL) carriers. Each carrier publishes a fuel-surcharge schedule tied to the weekly DOE/EIA on-highway diesel price index; this API returns the exact percentage each carrier's published schedule yields for the current diesel price, updated on the weekly DOE cadence.

Newly launched

The fuel-surcharge endpoints are newly launched. Coverage and response fields may expand — check the changelog for updates.

Endpoints

MethodEndpointDescription
GET/v1/fuel-surchargeAll covered carriers with latest surcharge
GET/v1/fuel-surcharge/{carrier}/latestCurrent surcharge for one carrier
GET/v1/fuel-surcharge/{carrier}/historyWeekly surcharge series for one carrier

Plan Availability

All three fuel-surcharge endpoints are available on every plan, including the free tier. There is no tier gating — usage counts against your plan's normal monthly request limit.

See pricing plans for current plan details.

Carrier Codes

Use these codes in the {carrier} path segment:

CodeCarrierMode
odflOld Dominion Freight LineLTL
saiaSaia LTL FreightLTL
estesEstes Express LinesLTL
fedex-freightFedEx FreightLTL
xpoXPOLTL
rl-carriersR+L CarriersLTL
abfABF FreightLTL
tforceTForce FreightLTL
averittAveritt ExpressLTL
southeastern-freightSoutheastern Freight LinesLTL

Parcel carriers (UPS, FedEx, DHL) are coming soon.

An unknown carrier code returns 404 Not Found.

How It Works

  1. Each carrier publishes a fuel-surcharge schedule: a table mapping DOE on-highway diesel price bands to a surcharge percentage.
  2. Every week the DOE/EIA publishes the national average on-highway diesel price.
  3. We match the current DOE price against each carrier's published schedule and return the resulting percentage, the matched diesel band, and the effective date.

Data Provenance

We track the fuel-surcharge schedule each carrier publishes; every response includes source (the URL of the carrier's published schedule) and retrieved_at (when we last retrieved it). If a carrier's schedule fetch is delayed, the API keeps serving the last retrieved value with its true effective_date and retrieved_at — freshness is never faked.

Authentication

All endpoints require an API key:

Authorization: Token YOUR_API_KEY

Related Endpoints

  • /v1/prices/latest - Latest commodity prices, including diesel codes
  • /v1/prices/historical - Historical price series
Last Updated: 7/17/26, 7:46 PM
Next
List Fuel Surcharges