List Fuel Surcharges

Get the latest published fuel-surcharge percentage for all covered carriers in a single request.

Newly launched

This endpoint is newly launched. See the Fuel Surcharge overview for carrier coverage and plan availability.

Endpoint

GET /v1/fuel-surcharge

Authentication

This endpoint requires authentication. Include your API key in the request header:

Authorization: Token YOUR_API_KEY

Available on all plans, including the free tier. Usage counts against your plan's monthly request limit.

Response

{
  "status": "success",
  "data": {
    "carriers": [
      {
        "carrier": "odfl",
        "carrier_name": "Old Dominion Freight Line",
        "mode": "ltl",
        "surcharge_percent": 33.9,
        "effective_date": "2026-07-13",
        "doe_diesel_price": 3.756,
        "diesel_band": { "min": 3.7, "max": 3.79 },
        "source": "https://www.odfl.com/us/en/resources/fuel-surcharge.html",
        "retrieved_at": "2026-07-15T12:00:00Z"
      }
      // ... one entry per covered carrier
    ]
  }
}

Response Fields

FieldTypeDescription
carrierstringCarrier code (see the carrier code table)
carrier_namestringFull carrier name
modestringFreight mode (ltl)
surcharge_percentnumberCurrent fuel-surcharge percentage from the carrier's published schedule
effective_datedateDate the surcharge took effect (ISO 8601)
doe_diesel_pricenumberThe DOE/EIA on-highway diesel price the schedule was matched against
diesel_bandobjectThe diesel price band (min/max) matched in the carrier's schedule
sourcestringURL of the carrier's published fuel-surcharge schedule
retrieved_atstringWhen we last retrieved the carrier's schedule (ISO 8601)

Examples

curl

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/fuel-surcharge

Python

import requests

response = requests.get(
    'https://api.oilpriceapi.com/v1/fuel-surcharge',
    headers={
        'Authorization': 'Token YOUR_API_KEY',
        'Accept': 'application/json'
    }
)
data = response.json()

for carrier in data['data']['carriers']:
    print(f"{carrier['carrier_name']}: {carrier['surcharge_percent']}% "
          f"(effective {carrier['effective_date']})")

Data Provenance

We track the fuel-surcharge schedule each carrier publishes; every response includes source and retrieved_at. If a carrier's schedule fetch is delayed, the last retrieved value is served with its true effective_date and retrieved_at.

Error Responses

Status CodeDescription
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
Last Updated: