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

Files

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.

FileFormatWhat it holds
carrier-rules.jsonJSONDIM divisors for every carrier and service, size and surcharge limits, USPS DIM, cubic and nonstandard rules, Amazon FBA tiers, sources.
carrier-boxes.jsonJSONUSPS, UPS and FedEx box sizes, and U-Haul, Home Depot and Lowe's moving boxes, with source and date for each.
changelog.jsonJSON6 dated rule changes, each with the carrier documents.
contradictions.jsonJSON7 places where two documents of one carrier or seller disagree, with both quotes and links.
dim-divisors.csvCSV13 carrier services, one row each.
size-limits.csvCSV79 limits, one row each (rule set, rule, field, value).
carrier-boxes.csvCSV64 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

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

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.

Updates

How we keep the data current

  1. We read the carrier documents again each January and July, and when a carrier announces a change.
  2. We change the rule in the calculators and add a dated entry to the change log.
  3. 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.

FAQ

Questions

What is in the carrier rules dataset?
It holds DIM weight divisors, size and surcharge limits, and USPS cubic and nonstandard rules. It also holds Amazon FBA size tiers, carrier and moving box sizes, and a dated log of rule changes.
Can I use the data in a commercial app?
Yes. The licence is CC BY 4.0. Give credit with a link to this page.
How often does the data change?
Carriers change rules a few times each year, usually in January and July. We update the files when they do.
Where does the data come from?
Every value comes from a page or a PDF of the carrier or the seller. Each section of the files lists its sources.