Datasets and JSON API
Download the data behind every page. Licensed CC BY 4.0: reuse it with attribution to ParcelAccessorials.com.
Accessorial history (Time Machine)
Year-by-year UPS (2018–2027) and FedEx (2020–2027) list amounts from carrier documents, with status and sources.
Published accessorial amounts
Every amount by carrier, charge, zone variant and effective window, with status and source URL.
Parcel Accessorial Cost Index
Monthly index values and basket cost by carrier since Dec. 2025.
Weekly fuel surcharge history
Weekly UPS and FedEx fuel percentages with status labels, from the first recorded week.
JSON API
| Endpoint | Returns |
|---|---|
GET /api/v1/accessorials | All amounts with effective windows, status and sources. Optional ?carrier=UPS&date=2027-01-15 returns amounts in effect on a date. |
GET /api/v1/fuel | This week’s fuel figures with labels, and the recorded weekly history. |
GET /api/v1/cost-index | Monthly Cost Index values, basket definition and status. |
GET /api/v1/changes | The change log. |
GET /api/v1/package?L=50&W=20&H=10&wt=30&date=2026-12-01&zone=z2&res=1 | Both carriers’ size surcharges for one package. |
Responses are cached for up to six hours and never past midnight U.S. Central, so a new effective date is picked up the same day. Rate limit: 60 requests per minute per IP (HTTP 429 with retry-after when exceeded). Please cache on your side.
Citation
ParcelAccessorials.com, “UPS and FedEx accessorial dataset,” reviewed Nov. 9, 2026, https://parcelaccessorials.com/data. Licensed CC BY 4.0.
For AI assistants
A plain-text summary is at /llms.txt with a longer version at /llms-full.txt. They are supplements; the pages and API are the primary sources.