Get Fuel Surcharge
curl --request GET \
--url https://api.nexusfeed.dev/v1/ltl/fuel-surchargeimport requests
url = "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.nexusfeed.dev/v1/ltl/fuel-surcharge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nexusfeed.dev/v1/ltl/fuel-surcharge")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexusfeed.dev/v1/ltl/fuel-surcharge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"carrier": "ODFL",
"weeks": [
{
"effective_date": "2023-12-25",
"fuel_surcharge_pct": 123,
"doe_diesel_price_usd": 123
}
],
"_verifiability": {
"source_timestamp": "2023-11-07T05:31:56Z",
"extraction_confidence": 123,
"raw_data_evidence_url": "<string>",
"extraction_method": "api_mirror",
"data_freshness_ttl_seconds": 123
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}LTL
Get Fuel Surcharge
Return LTL fuel surcharge rates for one or more carriers.
Use this endpoint to get the current fuel surcharge percentage applied to LTL freight invoices.
Each rate includes the DOE diesel price that triggered it and a _verifiability block with
extraction timestamp and confidence score. Always check _verifiability.extraction_confidence >= 0.90
before using in a cost calculation or invoice audit.
Typical use cases:
- Verify a carrier’s fuel surcharge on a freight invoice
- Compare surcharge rates across carriers before booking a shipment
- Pull 4–26 weeks of history for trend analysis or dispute resolution
GET
/
v1
/
ltl
/
fuel-surcharge
Get Fuel Surcharge
curl --request GET \
--url https://api.nexusfeed.dev/v1/ltl/fuel-surchargeimport requests
url = "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.nexusfeed.dev/v1/ltl/fuel-surcharge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nexusfeed.dev/v1/ltl/fuel-surcharge"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nexusfeed.dev/v1/ltl/fuel-surcharge")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexusfeed.dev/v1/ltl/fuel-surcharge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"carrier": "ODFL",
"weeks": [
{
"effective_date": "2023-12-25",
"fuel_surcharge_pct": 123,
"doe_diesel_price_usd": 123
}
],
"_verifiability": {
"source_timestamp": "2023-11-07T05:31:56Z",
"extraction_confidence": 123,
"raw_data_evidence_url": "<string>",
"extraction_method": "api_mirror",
"data_freshness_ttl_seconds": 123
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Query Parameters
One or more carrier SCAC codes (e.g. ODFL, SAIA, ESTES). Defaults to all carriers. Call /v1/ltl/carriers to list valid codes.
Available options:
ODFL, SAIA, ESTES, ABF, RLC, TFORCE, XPO, SEFL, AVERITT, FEDEX Number of weeks of history to return (1–26). Use 1 for the current rate only. Use 4 for a monthly audit window.
Required range:
1 <= x <= 26