Latest Carrier Fuel Surcharge

Get the current published fuel-surcharge percentage for a single carrier, with the effective date, the matched diesel-price band, and the underlying DOE diesel price.

Newly launched

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

Endpoint

GET /v1/fuel-surcharge/{carrier}/latest

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.

Path Parameters

Parameter	Type	Required	Description
`carrier`	string	Yes	Carrier code, e.g. `odfl` (see the carrier code table)

Response

{
  "status": "success",
  "data": {
    "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"
  }
}

Response Fields

Field	Type	Description
`carrier`	string	Carrier code
`carrier_name`	string	Full carrier name
`mode`	string	Freight mode (`ltl`)
`surcharge_percent`	number	Current fuel-surcharge percentage from the carrier's published schedule
`effective_date`	date	Date the surcharge took effect (ISO 8601)
`doe_diesel_price`	number	The DOE/EIA on-highway diesel price the schedule was matched against
`diesel_band`	object	The diesel price band (`min`/`max`) matched in the carrier's schedule
`source`	string	URL of the carrier's published fuel-surcharge schedule
`retrieved_at`	string	When 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/odfl/latest

JavaScript

const response = await fetch(
  "https://api.oilpriceapi.com/v1/fuel-surcharge/odfl/latest",
  {
    headers: {
      Authorization: "Token YOUR_API_KEY",
      Accept: "application/json",
    },
  },
);
const { data } = await response.json();

console.log(
  `${data.carrier_name}: ${data.surcharge_percent}% (effective ${data.effective_date})`,
);

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 Code	Description
401	Unauthorized - Invalid or missing API key
404	Not Found - Unknown carrier code
429	Too Many Requests - Rate limit exceeded

/v1/fuel-surcharge - All covered carriers with latest surcharge
/v1/fuel-surcharge/{carrier}/history - Weekly surcharge series for one carrier