Carrier API Errors & Scan Status Reference
Calling carrier tracking endpoints directly from serverless runtimes (Cloudflare Workers, Vercel Functions, AWS Lambda) or legacy webhook aggregators often fails due to WAF blocks, multi-step OAuth handshakes, or asynchronous registration queues.
Use our interactive Carrier API Error Decoder or the reference below to replace brittle carrier integrations with a single GET https://api.lastscanned.com/v1/track/{number} request.
Common Carrier API Errors & Fixes
| Carrier / Provider | Error Code / Symptom | Why It Happens | lastscanned Resolution |
|---|---|---|---|
| UPS | HTTP 403 Forbidden / 428 Precondition Required / 250003 Invalid Access License | UPS deprecated XML Access Keys (250003) and gates its REST Track API behind Akamai Bot Manager, blocking cloud datacenter ASNs. | Call GET /v1/track/1Z... — zero UPS shipper account credentials or OAuth token caches required. |
| USPS | Web Tools TrackV2 XML retired / v3 OAuth 401 & 429 / 92… blind spots | USPS retired legacy Web Tools XML and requires Business Customer Gateway OAuth 2.0, while omitting OSM/Pitney Bowes middle-mile scans. | Call GET /v1/track/9400... (and pass ?carrier=osm or ?carrier=pitneybowes on 92… consolidator labels). |
| FedEx | HTTP 422 Unprocessable Entity / NOT.AUTHORIZED.ERROR | Short-lived OAuth bearer token churn in stateless edge workers and production key validation gates. | Call GET /v1/track/{number} with your static lsk_live_... key; 12/15/20/22-digit FedEx numbers auto-detect. |
| Veho / UniUni / SpeedX / GOFO / OnTrac | HTTP 401 / 403 Firebase App Check / No public self-serve API | Regional e-commerce couriers gate tracking behind browser-minted Firebase App Check tokens or enterprise contracts. | All regional couriers (veho, uniuni, speedx, gofo, ontrac, bettertrucks, intelcom) work out of the box via GET /v1/track/{number}. |
| 17TRACK | -18019902 ("Not registered yet") / -18010020 ("Additional parameters incorrect") | 17TRACK requires async POST /register before querying, charges 10 quotas/call for getRealTimeTrackInfo, and requires extra params (mid, postal_code) on 150 carriers. | Synchronous on the first GET for 1 quota, with zero extra parameters required. See Migrating from 17TRACK. |
Top 45 Cryptic Carrier Scan Statuses (statusDescription → status)
Every carrier uses different raw phrasing for middle-mile consolidator handoffs, customs clearance, and delivery exceptions. lastscanned preserves the verbatim carrier text in statusDescription and events[].description while mapping it to our 7-value normalized status enum (pre_shipment, in_transit, out_for_delivery, delivered, exception, expired, unknown):
-
USPS & Consolidators:
Picked Up by Shipping Partner, USPS Awaiting Item·Shipping Label Created, USPS Currently Awaiting Package·Arrived Shipping Partner Facility, USPS Awaiting Item·Departed Shipping Partner Facility, USPS Awaiting Item·Accepted at USPS Destination Facility·In Transit to Next Facility, Arriving Late·Held at Post Office, At Customer Request·Available for Pickup·No Access to Delivery Location·Receptacle Blocked·Alert: Awaiting Delivery Scan -
Regional Last-Mile (UniUni, SpeedX, GOFO, Veho, OnTrac):
Gateway transit in·Gateway transit out·Parcel is out for delivery·Arrived at SpeedX Facility·Processing at Designated Facility·Match to Manifesto·Unable to Locate -
Cross-Border (Cainiao, YunExpress, Yanwen, 4PX, CNE):
Import customs clearance complete·Handed over to local carrier·Arrived at linehaul office·Leaving from departure country/region -
National & Canadian (UPS, FedEx, Purolator, Intelcom/Dragonfly):
Delivered to PUDO·Shipment Exception — Weather Delay·On the way to your Dragonfly depot -
European, UK & Nordic (InPost, Evri, DPD UK, Colissimo, PostNL, DHL Paket, PostNord):
InPost Ready for collection (Paczkomat)·Evri Parcel at ParcelShop·DPD UK At our depot·Colissimo En cours d'acheminement·PostNL Parcel at sorting center·DHL Processed in export parcel center·PostNord Under transportation -
APAC, India & Global Cross-Border (Delhivery, Blue Dart, Yamato, Ninja Van, SFC, Winit, Meest, Hualei):
Hualei 等待签收 (Waiting for sign-off = in_transit)·Yamato 調査中 / 持戻·Ninja Van Processed at warehouse·Delhivery Received at Origin Center·Blue Dart Out For Delivery·SFC Dispatched from sorting center·Winit Outbound from warehouse·Meest International sorting center·Passport Cleared customs·Chit Chats Handed over to partner carrier
Explore all 45 interactive scan status guides at https://lastscanned.com/status.
Consolidator & Cross-Border Handoffs
How to track USPS 92… consolidator labels (OSM Worldwide, Pitney Bowes, DHL eCommerce, UPS Mail Innovations, ACI, APC) and cross-border handoffs (Cainiao, YunExpress, Yanwen, 4PX, CNE, Landmark Global) without multi-day blind spots.
Migrating from 17TRACK API to lastscanned
Replace 17TRACK's async POST /register queue, 10x getRealTimeTrackInfo quota penalty, and April 2026 USPS Mailer ID (mid) / -18010020 parameter errors with a single synchronous GET call.