Skip to content

Package tracking, shipping estimates and shipment history

Back to tools

UPS ships and delivers packages, provides available tracking status and history, and estimates guest retail prices and delivery times, with end-of-day shown as 23:59 local time and counter prices varying.

Estimate shipping

Estimate UPS guest retail shipping prices and delivery times from postal codes and package weight. End-of-day arrivals are shown as 23:59 local time, not a promised clock time; retail counter prices may vary.

Your information

Sender postal code and two-letter country code, e.g. 10001, US.

Package width in inches, e.g. 8.

Package height in inches, e.g. 6.

Package length in inches, e.g. 12.

Date the package will ship, YYYY-MM-DD, e.g. 2026-09-29. Defaults to the next business day.

Weight in pounds, e.g. 5.

Recipient postal code and two-letter country code, e.g. 90210, US.

Whether delivery is to a home, e.g. true. Defaults to yes.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Shipping estimates

Choose an action

About the UPS tool

UPS returns package status, delivery details, and shipment history from a tracking number.

Estimate shipping returns retail prices and delivery times using origin, destination, and package weight.

Built from ups.com, open-meteo.com and zippopotam.us. Last checked Sep 30, 2026.

Actions

Estimate shipping

1 credit

Estimate UPS guest retail shipping prices and delivery times from postal codes and package weight. End-of-day arrivals are shown as 23:59 local time, not a promised clock time; retail counter prices may vary.

Uses UPS, open-meteo.com and zippopotam.us.

What you provide

FieldTypeRequiredDescription
OriginoriginTextRequiredSender postal code and two-letter country code, e.g. 10001, US.Example: 10001, US
Width inwidth_inNumberOptionalPackage width in inches, e.g. 8.Example: 8
Height inheight_inNumberOptionalPackage height in inches, e.g. 6.Example: 6
Length inlength_inNumberOptionalPackage length in inches, e.g. 12.Example: 10
Ship Dateship_dateDateOptionalDate the package will ship, YYYY-MM-DD, e.g. 2026-09-29. Defaults to the next business day.Example: 2026-09-30
Weight (lb)weight_lbNumberRequiredWeight in pounds, e.g. 5.Example: 2
DestinationdestinationTextRequiredRecipient postal code and two-letter country code, e.g. 90210, US.Example: 60601, US
Residential Deliveryresidential_deliveryYes or noOptionalWhether delivery is to a home, e.g. true. Defaults to yes.Example: No

What you get

FieldTypeDescription
ServicesservicesListAvailable UPS services, ordered by retail price.
Currencyservices[].currencyTextExample: USD
Ups Linkservices[].ups_linkLinkExample: https://wwwapps.ups.com/ctc/request?loc=en_US
Guaranteedservices[].guaranteedYes or noExample: No
Retail Priceservices[].retail_priceNumberExample: 17.56
Service Nameservices[].service_nameTextExample: UPS Ground
Delivery Date Timeservices[].delivery_date_timeDateExample: 2026-10-02T23:59:00-05:00
Business Days in Transitservices[].business_days_in_transitNumberExample: 2

Example result

For Origin: 10001, US, Width in: 8, Height in: 6, Length in: 10, Ship Date: 2026-09-30, Weight (lb): 2, Destination: 60601, US, Residential Delivery: No

JSON
{
  "services": [
    {
      "currency": "USD",
      "ups_link": "https://wwwapps.ups.com/ctc/request?loc=en_US",
      "guaranteed": false,
      "retail_price": 17.56,
      "service_name": "UPS Ground",
      "delivery_date_time": "2026-10-02T23:59:00-05:00",
      "business_days_in_transit": 2
    },
    {
      "currency": "USD",
      "ups_link": "https://wwwapps.ups.com/ctc/request?loc=en_US",
      "guaranteed": false,
      "retail_price": 44.16,
      "service_name": "UPS 3 Day Select",
      "delivery_date_time": "2026-10-05T23:59:00-05:00",
      "business_days_in_transit": 3
    },
    {
      "currency": "USD",
      "ups_link": "https://wwwapps.ups.com/ctc/request?loc=en_US",
      "guaranteed": false,
      "retail_price": 49.5,
      "service_name": "UPS 3 Day Select (Saturday Delivery)",
      "delivery_date_time": "2026-10-03T23:59:00-05:00",
      "business_days_in_transit": 3
    }
  ]
}

Track package

1 credit

Track a UPS package by tracking number, including its status, delivery details and shipment history when available.

What you provide

FieldTypeRequiredDescription
Tracking Numbertracking_numberTextRequiredUPS tracking number, with or without spaces, for example 1Z999AA10123456784.Example: 1Z999AA10123456784

What you get

FieldTypeDescription
OriginoriginTextExample: Germany
StatusstatusTextExample: Delivered
WeightweightText
HistoryhistoryList
Locationhistory[].locationTextExample: LONGVIEW, TX, US
Date Timehistory[].date_timeDateExample: 2025-12-05T10:29:38-06:00
Descriptionhistory[].descriptionTextExample: DELIVERED
Left Atleft_atTextExample: Other
DestinationdestinationTextExample: LONGVIEW, TX, US
Delivered Atdelivered_atDateExample: 2025-12-05T10:29:38-06:00
Service Typeservice_typeTextExample: UPS Express™ 12:00
Tracking Linktracking_linkTextExample: https://www.ups.com/track?loc=en_US&tracknum=1Z999AA10123456784
Tracking Numbertracking_numberTextExample: 1Z999AA10123456784
Scheduled Delivery Datescheduled_delivery_dateDate
Scheduled Delivery Window Endscheduled_delivery_window_endDate
Scheduled Delivery Window Startscheduled_delivery_window_startDate

Example result

For Tracking Number: 1Z999AA10123456784

JSON
{
  "origin": "Germany",
  "status": "Delivered",
  "weight": null,
  "history": [
    {
      "location": "LONGVIEW, TX, US",
      "date_time": "2025-12-05T10:29:38-06:00",
      "description": "DELIVERED"
    },
    {
      "location": "Longview, TX, United States",
      "date_time": "2025-12-05T10:20:03-06:00",
      "description": "Out For Delivery Today"
    },
    {
      "location": "Longview, TX, United States",
      "date_time": "2025-12-05T09:26:36-06:00",
      "description": "Processing at UPS Facility"
    }
  ],
  "left_at": "Other",
  "destination": "LONGVIEW, TX, US",
  "delivered_at": "2025-12-05T10:29:38-06:00",
  "service_type": "UPS Express™ 12:00",
  "tracking_link": "https://www.ups.com/track?loc=en_US&tracknum=1Z999AA10123456784",
  "tracking_number": "1Z999AA10123456784",
  "scheduled_delivery_date": null,
  "scheduled_delivery_window_end": null,
  "scheduled_delivery_window_start": null
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@ups",
  "visibility": "public",
  "operation": "estimate_shipping",
  "version": 1,
  "input": {
    "origin": "10001, US",
    "width_in": 8,
    "height_in": 6,
    "length_in": 10,
    "ship_date": "2026-09-30",
    "weight_lb": 2,
    "destination": "60601, US",
    "residential_delivery": false
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

  • Check package status and delivery details
  • Review shipment history by location and time
  • Compare estimated shipping prices and delivery times
  • Plan shipments using origin and destination postal codes

Questions about UPS

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this UPS tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a UPS account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from ups.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.

What is the package's current status?

Track package uses a tracking number to return package status and shipment history when available.

Which shipping services and prices are estimated?

Estimate shipping returns available services, retail prices, and estimated delivery times for the supplied shipment details.

All Logistics toolsBrowse all tools