UPS Ground Saver (formerly SurePost): Service Codes and API Setup
UPS Ground Saver is the current name for the service that used to be called UPS SurePost. UPS renamed it on April 1, 2025. It is an economy ground service where USPS often handles the final delivery.
There is no "Ground Saver" service code#
The rename was cosmetic. UPS kept the same service codes in its APIs, so there is no new code to look up — use the SurePost codes you may already know:
service |
Service |
|---|---|
92 |
UPS Ground Saver — less than 1 lb |
93 |
UPS Ground Saver — 1 lb or greater |
94 |
UPS Ground Saver — BPM |
95 |
UPS Ground Saver — Media Mail |
Pick 92 or 93 by package weight; that is the only difference between them.
Rate and label responses still come back described as "UPS SurePost".
Ground Saver must be enabled on your UPS account before these codes will rate or produce labels. If UPS rejects the service as unavailable, that is an account entitlement question for your UPS rep, not a problem with the request.
Rating#
Ground Saver rates never appear in a shop-all-services response. You have to
ask for the specific service code with the Rate request option:
- On
UPS-REST, pass"request_option": "Rate"yourself — the default isShoptimeintransit, which will not return Ground Saver. - On the legacy
UPS(SOAP) carrier, settingserviceswitches the request option toRateautomatically.
For packages under 1 lb (92), send the weight in ounces with
"weight_unit": "OZS". Sending a fractional pound weight instead returns:
The unit of measure is invalid for either the selected service and/or packaging. Verify the selected Service and Packaging is valid for this shipment type
{
"carrier": "UPS-REST",
"action": "getallrates",
"params": {
"test": true,
"key": "your-key-from-authenticate-request",
"account_number": "YOUR_ACCOUNT",
"service": "92",
"request_option": "Rate",
"weight_unit": "OZS",
"packaging_type": "02",
"packages": [
{
"weight": 0.6,
"length": 9,
"width": 6,
"height": 1
}
],
"shipper": "Acme Inc",
"ship_addr1": "123 Main St.",
"ship_city": "Vancouver",
"ship_state": "WA",
"ship_code": "98685",
"ship_country": "US",
"to_code": "06333",
"to_state": "CT",
"to_country": "US",
"residential": true,
"negotiated_rates": true
}
}
Labels#
A Ground Saver label is an ordinary submitshipment request with the service
code set:
{
"carrier": "UPS-REST",
"action": "submitshipment",
"params": {
"key": "your-key-from-authenticate-request",
"account_number": "YOUR_ACCOUNT_NUMBER",
"service": "93",
"packages": [
{
"weight": 4,
"length": 7
}
],
"shipper": "RocketShipIt",
"ship_addr1": "123 Main St",
"ship_city": "Whitehall",
"ship_state": "MT",
"ship_code": "59759",
"ship_phone": "1231231234",
"ship_country": "US",
"to_name": "John Doe",
"to_addr1": "940 Presidio Ave",
"to_addr2": "#103",
"to_state": "CA",
"to_city": "San Francisco",
"to_code": "94115",
"to_country": "US",
"image_type": "GIF",
"test": true
}
}
International Ground Saver shipments require a CN22 customs form, the USPS equivalent of a commercial invoice.
Examples:
- https://docs.rocketshipit.com/2-0/examples/ups-rest-rates-surepost.html
- https://docs.rocketshipit.com/2-0/examples/ups-rest-label-surepost.html
See also UPS Mail Innovations, the higher-volume UPS mailing product, and FedEx SmartPost, the FedEx equivalent.