UPSTracker is a Node.js service that fetches real-time order status from UPS using tracking numbers.

What UPS tracking info can I access? 📦

1. Package Status:

   • Status Code: statusCode (e.g., "200")
   • Status Text: statusText (e.g., "Successful")
   • Package Status: trackDetails[0].packageStatus (e.g., "Shipment Ready for UPS")

2. Weight:

   • Weight: trackDetails[0].additionalInformation.weight (e.g., "1.00 LBS")
   • Weight Unit: trackDetails[0].additionalInformation.weightUnit (e.g., "LBS")

3. Service Type:

   • Service Name: trackDetails[0].additionalInformation.serviceInformation.serviceName (e.g., "UPS Ground")

4. Delivery Address:

   • City: trackDetails[0].shipToAddress.city (e.g., "ALISO VIEJO")
   • State: trackDetails[0].shipToAddress.state (e.g., "CA")
   • Country: trackDetails[0].shipToAddress.country (e.g., "US")

5. Progress Events:

   • Milestones:
     • Current Milestone: trackDetails[0].milestones (list of milestone objects, each with details like date, time, location, and name)
   • Shipment Progress Activities:
     • Activity Scan: trackDetails[0].shipmentProgressActivities (list of activities with date, time, location, and description)

Input Format

You can enter up to 20 tracking numbers in a single request.

1{
2  "trackingNumbers": ["1ZB350090325362692"]
3}

Output Examples

✅ Valid Tracking Number

1[
2  {
3    "trackNumber": "1Z3TWW700308932865",
4    "result": {
5      "statusCode": "200",
6      "statusText": "Successful",
7      "isLoggedInUser": false,
8      "trackedDateTime": "10/03/2024 3:43 P.M. EST",
9      "isBcdnMultiView": false,
10      "returnToDetails": {
11        "returnToURL": null,
12        "returnToApp": null
13      },
14      "trackDetails": [
15        {
16          "errorCode": null,
17          "errorText": null,
18          "requestedTrackingNumber": "1Z3TWW700308932865",
19          "trackingNumber": "1Z3TWW700308932865",
20          "isMobileDevice": false,
21          "packageStatus": "Shipment Ready for UPS",
22          "packageStatusType": "M",
23          "packageStatusCode": "003",
24          "progressBarType": "ManifestUpload",
25          "progressBarPercentage": null,
26          "simplifiedText": "",
27          "endOfDayResCMSKey": null,
28          "receivedBy": "",
29          "leaveAt": null,
30          "nextExpectedEvent": null,
31          "milestones": [],
32          "altTrkNumInfo": null,
33          "alertCount": 0,
34          "isEligibleViewMoreAlerts": false,
35          "cdiLeaveAt": null,
36          "leftAtActionCMSKey": "cms.stapp.at",
37          "leftAt": "",
38          "showNoInfoDate": false,
39          "showPickupByDate": false,
40          "shipToAddress": {},
41          "shipFromAddress": null,
42          "consigneeAddress": null,
43          "deliveryAddress": null,
44          "signatureImage": "",
45          "trackHistoryDescription": null,
46          "additionalInformation": {}
47        }
48      ]
49    }
50  }
51]

❌ Invalid Tracking Number

1[
2  {
3    "trackNumber": "1Z3TWW700308932865",
4    "result": { "errorMessage": "INVALID_TRACKING_NUMBER" }
5  }
6]

Your Feedback 🙏

If you have any feedback or notice any bugs, please create an issue on the Issues tab in Apify Console. Thank you!