A shipping API is the connection between your systems and a carrier. It fetches rates, buys labels, and pulls tracking updates without anyone logging into a carrier site. That is the clean version. The messy version is that every carrier's API is different, some are slow, and a few barely work. One carrier returns 12 status labels, another returns over a hundred, and none of them agree. So your tracking page shows raw carrier jargon instead of a clear step. This guide explains what a shipping API does and how to handle the gaps.
What a shipping API does: rates, labels, tracking
A shipping API does three core jobs. It quotes rates, it buys labels, and it returns tracking updates. Each one replaces a manual task someone used to do in a carrier portal.
Rates come first. Your system asks the carrier "what does it cost to ship this parcel to this address at this service level?" and gets a number back in real time. That number can feed checkout, or feed a routing decision behind the scenes.
Labels come next. Once you pick a service, the API buys the label and returns a file you print. Tracking is the third job. After the parcel ships, the API pulls scans so you can show the customer where it is. These three jobs are the whole reason a shipping API exists.
Direct carrier APIs vs aggregators
You can connect to carriers two ways. Straight to each carrier's own API, or through an aggregator that speaks to many carriers behind one connection.
The trade-off is control versus effort. Here is how the two compare.
| Direct carrier API | Aggregator | |
|---|---|---|
| Connections to build | One per carrier | One, to the aggregator |
| Data control | Full, raw from source | Depends on the aggregator |
| Maintenance | You handle every change | Aggregator absorbs most changes |
| Best when | You need one or two carriers deeply | You want many carriers fast |
Neither is automatically right. A brand on two carriers might go direct and keep full control. A brand adding carriers often takes the aggregator to avoid building the same plumbing five times. Many brands end up with a mix.
Why carrier data is so inconsistent (10 to 115 statuses)
Here is the part nobody warns you about. Carriers do not agree on what a tracking status even means. One carrier ships 12 distinct status codes. Another ships over a hundred. They use different words for the same event and the same word for different events.
So "your parcel is on its way" might arrive as "in transit," "departed facility," "accepted," or a numeric code, depending on which carrier scanned it. If you show that raw data to a customer, your tracking page reads like a logistics dictionary instead of a clear step.
This is not a bug you can fix with one carrier. It is the state of the whole field. The messy carrier data problem sits underneath every multi-carrier shipping setup, and it only gets worse as you add carriers.
What happens when a carrier API is slow or incomplete
Not every API works well. Some are slow to respond. Some return partial data. A few carriers, especially regional ones, barely expose an API at all.
When an API is slow, your tracking page lags behind reality. The parcel is out for delivery, but your page still says "in transit" because the last poll timed out. When an API is incomplete, whole events go missing, so the customer sees a gap and assumes the parcel is lost.
The honest answer is that you cannot always get clean data from the API alone. Sometimes the tracking data lives on the carrier's website but not in a usable API. That gap is real, and pretending otherwise leads to a broken tracking experience.
The difference between raw carrier data and a clean status
Raw carrier data is what the API returns. A clean status is what the customer should see. These are not the same thing, and the work of turning one into the other is where most tracking pages fall down.
A clean status maps every carrier's vocabulary onto one simple set of steps. Ordered. Shipped. In transit. Out for delivery. Delivered. Exception. The customer sees the same five or six steps no matter which carrier carried the parcel.
Getting there means normalizing every carrier's labels into that shared set. It is unglamorous work, and it never fully stops because carriers change their codes. But it is the difference between a tracking page a customer trusts and one that confuses them. Our guide to carrier tracking statuses goes deeper on how that mapping works.
How Pango fits: normalize APIs and scrape gaps where APIs are poor
Pango is one adaptive layer over your orders, carriers, warehouses, and returns. It is not a WMS or a 3PL. On the carrier-data problem, it does two specific things.
First, it normalizes carrier APIs. Pango maps the 10 to 115 different status labels your carriers report into one clean set, so your tracking page shows a clear step instead of raw jargon. Second, where a carrier's API is poor or missing, Pango scrapes the tracking data the carrier exposes elsewhere. That fills the gaps the API leaves.
Live today: returns and exchanges, branded tracking with proactive notifications, and analytics across your orders and carriers. Custom logic beyond that is build-to-fit, built to match your carriers and policies rather than forced into a fixed template. If you are choosing how to route orders across those carriers once the data is clean, see order orchestration. For the full platform view, see the transportation management system (TMS) product page.
Shipping API, carrier API or multi-carrier API: which one are you looking for?
The three phrases get used for different things, and the difference decides how much you build yourself.
- A carrier API is one carrier's own interface: UPS, DHL, PostNord. It gives you that carrier's rates, labels and tracking in that carrier's vocabulary and nothing else. Adding a second carrier means a second integration, a second status set and a second place things break.
- A multi-carrier API sits in front of many carrier APIs and gives you one request shape for all of them. The quality varies with how well the aggregator normalises the responses; the raw status text often still leaks through, which is the inconsistency described above.
- A shipping API is the general term and usually means one of the two, so ask which. For a store that ships with more than one carrier, the practical question is not which API but who owns the normalisation layer: the aggregator, your own developers, or a platform that treats carrier data as its job.
The comparison of the platforms that do the last of those is in the best multi-carrier shipping software; what connecting a carrier actually involves is in carrier integration software.
What a shipping API returns
Whatever the vendor calls it, a shipping API returns four kinds of object, and the quality of each decides how much the brand builds itself.
| Call | What comes back | What to check |
|---|---|---|
| Rate request | A list of services with a price, a transit estimate and sometimes a delivery date, per carrier | Whether surcharges (fuel, remote area, oversize) are included, and whether the date is computed or copied from a published table |
| Label purchase | A label file in the carrier's format (PDF, ZPL, PNG), a tracking number, and for cross-border parcels the customs documents | Which formats, whether customs documents come on the same call, and what the error looks like when the address fails (the Packstation post number is the classic case) |
| Tracking | A list of events, each with a timestamp, a location, the carrier's raw status code and text, and sometimes a normalised status | Whether the normalised status exists at all, how many carrier vocabularies it maps, and whether an exception (failed attempt, customs hold, return) is flagged as one |
| Webhooks | A push of the same tracking events as they happen, instead of polling | Delivery guarantees, retries, and whether a delay is pushed as its own event |
The raw tracking event is the object that matters most and varies most: one carrier returns ten statuses, another over a hundred, and the text changes without notice. An API that returns only the raw event leaves the normalisation to the brand; one that returns a normalised status and an exception flag has done the work that turns a feed into a tracking page.
What to check before you build on a shipping API
Before you commit to a shipping API, check a few things that save pain later.
Ask which carriers it actually covers, and how it handles the ones with weak APIs. A carrier list means nothing if the data behind three of them is unusable. Ask how tracking statuses come back, and whether they are normalized or raw.
Then check the update speed and the failure behavior. How often does tracking refresh, and what happens when a poll fails? Finally, confirm whether the API buys labels and quotes rates, or only tracks. Knowing the gaps before you build beats discovering them in production.
Shipping API compared
Four shipping APIs, by what each vendor publishes on its own developer or pricing page, read on 2026-11-04. One fact per cell, quoted where the vendor's wording matters. Pango's row is its own product scope.
| API | What the API covers | Carriers, as the vendor states it | Published pricing | Where it is documented |
|---|---|---|---|---|
| EasyPost | "Labels, rate shopping, address verification, tracking, and insurance." (pricing page) | "100+ carriers." (carriers page) | "Free for up to 3,000 labels" with EasyPost's Wallet carriers, "Postage not included"; "Bring Your Own Carrier Accounts (BYOCA): $20/per month (plus per-label fee)"; Enterprise "Custom pricing based on volume"; Tracking API "$0.01-$0.03 per shipment" | docs.easypost.com |
| Shippo | "rates, labels, tracking, and address validation over REST, SDKs, or the hosted MCP server" (API docs) | "40+ carriers" (carriers page); "1000+ carriers for tracking" (API pricing page) | API Starter "Free": "30 labels per month free", then "7¢/label"; "US and international address validation (fees apply)"; "Tracking (fees apply)"; API Premier "Contact us" | docs.goshippo.com |
| ShipEngine, now ShipStation API | "purchasing labels, getting rates, tracking shipments, and validating addresses" (docs) | "200+ carriers" (pricing page), which also says "250+ carriers" | Free "$0.00 /month" using ShipStation's carrier accounts, with "Create labels and compare rates" and "Track your parcels"; Advanced "$75.00 /month" for "1,000 labels per month" plus "$0.075 per additional label", "$325.00 /month" for 5,000 and "$600.00 /month" for 10,000, with "Validate any address" and "Bring your own carrier accounts" from Advanced; Enterprise "Custom" above 25,000 shipments a month | shipengine.com/docs |
| Pango | Generate labels, retrieve real-time data, track shipments and verify addresses through its API and MCP, on the same system that runs checkout delivery, carrier routing, the warehouse, tracking and returns | Connects to more than 100 carriers through prebuilt connectors | Pricing is on pango.ai/pricing | API and MCP access for technical teams; the shipping scope is on the TMS product page |
Notes on the table. ShipEngine's documentation says "ShipEngine Rebranded as ShipStation API", dated 25 February 2025, with the same endpoints at api.shipengine.com, so the row carries both names. EasyPost's pricing page says "hundreds of carrier integrations" while its carriers page says "100+ carriers", and the carriers page figure is in the table. Shippo gives "40+ carriers" for shipping and "1000+ carriers for tracking", so both are shown. ShipStation's pricing page gives "200+ carriers" in its API section and "250+ carriers" in its rates line, so both are shown. EasyPost's documentation renders in the browser only and was read in a headless browser. Pango is an AI-native operating system for e-commerce logistics, not an order management system: it sits on top of the store's OMS, and its API is one way into the same operation. These are the vendors' own pages on the day, and prices change.



