---
title: "List current parcel carrier fuel surcharges"
method: GET
path: "/v1/fuel-surcharge/parcel"
tags: ["Fuel Surcharge"]
---

# List current parcel carrier fuel surcharges

`GET /v1/fuel-surcharge/parcel`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/fuel-surcharge/parcel`
- Auth: API key in header `Authorization`

Returns current published parcel fuel surcharges grouped by carrier and
service level, with effective dates and retrieval timestamps.

## Response `200`

Current parcel fuel surcharges by carrier and service level

- ParcelFuelSurchargeListResponse
  - `status` 'success', required
  - `data` object, required
    - `carriers` 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
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/7f8b4d763210?raw)