Get Fuel Surcharge

curl --request GET \
  --url https://api.nexusfeed.dev/v1/ltl/fuel-surcharge

{
  "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>",
    "data_freshness_ttl_seconds": 123
  }
}

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

ltl

fuel-surcharge

Get Fuel Surcharge

curl --request GET \
  --url https://api.nexusfeed.dev/v1/ltl/fuel-surcharge

{
  "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>",
    "data_freshness_ttl_seconds": 123
  }
}

Query Parameters

carriers

enum<string>[]

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

weeks

integer

default:4

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

Response

Successful Response

carrier

enum<string>

required

Available options:

ODFL,

SAIA,

ESTES,

ABF,

RLC,

TFORCE,

XPO,

SEFL,

AVERITT,

FEDEX

weeks

FuelSurchargeWeek · object[]

required

Show child attributes

_verifiability

Verifiability · object

required

Show child attributes

List Carriers

Documentation Index

Query Parameters

Response