v2

latestOpenAPI 3.0.4Commercial License2026-08-0718678294.5 KB
Fuel Surcharge

Get parcel fuel-surcharge history for one service level

Returns stored published parcel fuel-surcharge rows newest first for one carrier and required service level.

get/v1/fuel-surcharge/parcel/{carrier}/history

Path parameters

carrierstring required
Example:ups

Covered parcel carrier slug returned by the parcel list endpoint

Query parameters

service_levelstring required
Example:ground

Carrier service-level identifier returned by the parcel list endpoint

pageinteger

One-indexed result page

per_pageinteger

Results per page, capped at 100

Response

Paginated parcel fuel-surcharge history

status'success' required

Example response

{
  "data": {
    "history": [
      {
        "carrier": "odfl",
        "carrier_name": "Old Dominion Freight Line",
        "service_level": "ground",
        "surcharge_percent": 25.5
      }
    ]
  }
}