---
title: "Get current parcel fuel surcharges for one carrier"
method: GET
path: "/v1/fuel-surcharge/parcel/{carrier}/latest"
tags: ["Fuel Surcharge"]
---

# Get current parcel fuel surcharges for one carrier

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

Returns all current service-level surcharges for a parcel carrier, or a
single rate when `service_level` is provided.

## Path parameters

- `carrier` string, required

## Query parameters

- `service_level` string

## Response `200`

Current parcel carrier surcharge data

- union
  - FuelSurchargeRateResponse
    - `status` 'success', required
    - `data` FuelSurchargeRate, required
      - `carrier` string, required
      - `carrier_name` string, required
      - `mode` 'ltl' | 'parcel', required
      - `service_level` string — Present for parcel rates
      - `surcharge_percent` number, float, required
      - `effective_date` string, date, required
      - `doe_diesel_price` number, float, nullable, required
      - `diesel_band` object, nullable, required
        - `min` number, float, nullable, required
        - `max` number, float, nullable, required
      - `source` string, uri, required — Carrier-published schedule URL
      - `retrieved_at` string, date-time, required
  - ParcelFuelSurchargeCarrierResponse
    - `status` 'success', required
    - `data` ParcelFuelSurchargeCarrier, required
      - `carrier` string, required
      - `carrier_name` string, required
      - `mode` 'parcel', required
      - `service_levels` FuelSurchargeRate[], required
        - `carrier` string, required
        - `carrier_name` string, required
        - `mode` 'ltl' | 'parcel', required
        - `service_level` string — Present for parcel rates
        - `surcharge_percent` number, float, required
        - `effective_date` string, date, required
        - `doe_diesel_price` number, float, nullable, required
        - `diesel_band` object, nullable, required
          - `min` number, float, nullable, required
          - `max` number, float, nullable, required
        - `source` string, uri, required — Carrier-published schedule URL
        - `retrieved_at` string, date-time, required

## Other responses

- `401` — Unauthorized - Invalid API key
- `404` — Carrier, service level, or retrieved data is unavailable
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)