Carrier rules dataset
JSON & CSV, free to use
The rules that USPS, UPS, FedEx, DHL and Amazon use for DIM weight and size limits, and the sizes of their boxes. Each value has its source and the date that we checked it.
Rules checked: 22 September 2026 · Box sizes checked: 4 November 2026
Download the data
The files are free to use. They are the same data that the calculators on this site use. When we change a rule on the site, these files change too.
| File | Format | What it holds |
|---|---|---|
carrier-rules.json | JSON | DIM divisors for every carrier and service, size and surcharge limits, USPS DIM, cubic and nonstandard rules, Amazon FBA tiers, sources. |
carrier-boxes.json | JSON | USPS, UPS and FedEx box sizes, and U-Haul, Home Depot and Lowe's moving boxes, with source and date for each. |
changelog.json | JSON | 6 dated rule changes, each with the carrier documents. |
contradictions.json | JSON | 7 places where two documents of one carrier or seller disagree, with both quotes and links. |
dim-divisors.csv | CSV | 13 carrier services, one row each. |
size-limits.csv | CSV | 79 limits, one row each (rule set, rule, field, value). |
carrier-boxes.csv | CSV | 64 boxes, one row each, with source URL. |
Version 2026.11.04. Rules last checked against the carrier documents on 2026-09-22. Box sizes checked on 2026-11-04.
CAUTION: Carriers change rules, usually in January and July. Check the source of a value before you use it for billing.
Use the data in your code
The JSON files allow requests from any website, so you can read them from the browser. Please cache them; they change only a few times each year.
JavaScript
fetch("https://boxvolumecalculator.com/data/carrier-rules.json")
.then((r) => r.json())
.then((d) => {
const ups = d.dim_divisors.find((x) => x.carrier_id === "ups_dom" && x.service_id === "daily");
console.log(ups.divisor_in3_per_lb); // 139
});
Python
import json, urllib.request
url = "https://boxvolumecalculator.com/data/carrier-boxes.json"
d = json.load(urllib.request.urlopen(url))
for b in d["carrier_boxes"]["usps"]["flat_rate"]:
print(b["name"], b["inside"])
Units
Lengths are in inches, volumes in cubic inches and weights in pounds. Divisors are in in³/lb or cm³/kg. A null divisor means that the carrier does not publish that unit.
Licence and citation
You can copy, change and use the data, also for commercial work, under the CC BY 4.0 licence. Give credit with a link to this page.
The same files are on GitHub: srimurugansystems/carrier-rules-dataset. Watch the repository to see each change.
Suggested credit:
Data: <a href="https://boxvolumecalculator.com/data/">BoxVolumeCalculator carrier rules dataset</a> (CC BY 4.0)
The carriers own their rules and prices. This dataset collects them in one place with the source of each value.
How we keep the data current
- We read the carrier documents again each January and July, and when a carrier announces a change.
- We change the rule in the calculators and add a dated entry to the change log.
- We publish new files with a new version number.
Follow the changes: carrier rule change log · Atom feed · changelog.json.
To report an error, send the link to the carrier document to contactus@boxvolumecalculator.com.