{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipping/ups-ground-freight","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/ups-ground-freight","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/ups-ground-freight","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"UPS Ground Freight","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ups-ground-freight","__idx":0},"children":["UPS Ground Freight"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API's integration with UPS allows you to take advantage of UPS Ground Freight pricing (GFP)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["UPS Ground Freight is not listed as a UPS service. Instead, it is considered ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/advanced-options"},"children":["advanced option"]},". However, GFP is not returned in the list of advanced options when you ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carrier-options"},"children":["list carrier options"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The examples below will demonstrate how to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#rating-a-ups-ground-freight-shipment"},"children":["get rates for a UPS Ground Freight shipment"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#create-a-label-for-ups-ground-freight"},"children":["create a label for a UPS Ground Freight shipment"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ups-ground-freight-unavailable-in-batches","__idx":1},"children":["UPS Ground Freight Unavailable in Batches"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["UPS Ground Freight labels are unavailable in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/bulk"},"children":["batches"]},". This means that all UPS Ground Freight labels need to be created individually."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-freight-classifications-nmfc","__idx":2},"children":["Understanding Freight Classifications (NMFC)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Freight classifications are derived from the National Motor Freight Traffic Association. Your freight package will fall into one of the 18 supported freight classifications (otherwise known as the NMFC, short for ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://www.nmfta.org/nmfc"},"children":["National Motor Freight Classification"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The classes range from 50 to 500 and there are many tools online to help determine which estimated freight class you'll fall into. For example, lighter but larger items are going to be the higher classes while heavier but smaller items are going to be the lower classes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"supported-freight-classes","__idx":3},"children":["Supported Freight Classes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["50"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["55"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["60"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["65"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["70"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["77.5"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["85"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["92.5"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["100"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["110"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["125"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["150"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["175"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["200"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["250"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["300"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["500"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rating-a-ups-ground-freight-shipment","__idx":4},"children":["Rating a UPS Ground Freight Shipment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When getting rates, GFP rates will not be returned unless explicitly requested. This means, you need to make two separate rate calls for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ups_ground"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ups_ground_freight"]}," in order to compare them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use UPS Ground Freight rating, you will provide two properties in the advanced options object for the shipment: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_ups_ground_freight_pricing"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["freight_class"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"advanced_options\": {\n    \"use_ups_ground_freight_pricing\": true,\n    \"freight_class\": \"50\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-rate-request--response","__idx":5},"children":["Example Rate Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example includes the necessary values in a request to the rates endpoint."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/rates HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\n    \"advanced_options\": {\n      \"use_ups_ground_freight_pricing\": true,\n      \"freight_class\": \"175\"\n    },\n    \"validate_address\": \"no_validation\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"address_line2\": \"Suite 300\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"no\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 20.0,\n          \"unit\": \"pound\"\n        },\n        \"dimensions\": {\n          \"unit\": \"inch\",\n          \"length\": 20.0,\n          \"width\": 20.0,\n          \"height\": 20.0\n        }\n      }\n    ]\n  },\n  \"rate_options\": {\n    \"carrier_ids\": [\n      \"se-123890\"\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rate_response\": {\n    \"rates\": [\n      {\n        \"rate_id\": \"se-10523\",\n        \"rate_type\": \"shipment\",\n        \"carrier_id\": \"se-3143\",\n        \"shipping_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 206.38\n        },\n        \"insurance_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 0.00\n        },\n        \"confirmation_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 0.00\n        },\n        \"other_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 0.00\n        },\n        \"rate_details\": [\n          {\n            \"rate_detail_type\": \"shipping\",\n            \"carrier_description\": null,\n            \"carrier_billing_code\": \"Base Rate\",\n            \"carrier_memo\": null,\n            \"amount\": {\n              \"currency\": \"usd\",\n              \"amount\": 206.38\n            },\n            \"billing_source\": \"Carrier\"\n          }\n        ],\n        \"zone\": null,\n        \"package_type\": null,\n        \"delivery_days\": 5,\n        \"guaranteed_service\": false,\n        \"estimated_delivery_date\": \"2019-07-25T05:00:00.000ZPlus3$\",\n        \"carrier_delivery_days\": \"Tuesday 1/23 by 11:00 PM\",\n        \"ship_date\": \"2019-07-25T05:00:00.000Z\",\n        \"negotiated_rate\": false,\n        \"service_type\": \"UPS® Ground\",\n        \"service_code\": \"ups_ground_freight\",\n        \"trackable\": true,\n        \"carrier_code\": \"ups\",\n        \"carrier_nickname\": \"UPS\",\n        \"carrier_friendly_name\": \"UPS\",\n        \"validation_status\": \"valid\",\n        \"warning_messages\": [],\n        \"error_messages\": []\n      }\n    ],\n    \"invalid_rates\": [],\n    \"rate_request_id\": \"se-10126\",\n    \"shipment_id\": \"se-1001161\",\n    \"created_at\": \"2019-07-25T15:24:46.657Z\",\n    \"status\": \"completed\",\n    \"errors\": []\n  },\n  \"shipment_id\": \"se-1001161\",\n  \"carrier_id\": null,\n  \"service_code\": null,\n  \"external_shipment_id\": null,\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\",\n  \"created_at\": \"2019-07-25T15:24:46.657Z\",\n  \"modified_at\": \"2019-07-25T15:24:46.657Z\",\n  \"shipment_status\": \"pending\",\n  \"ship_to\": {\n    \"name\": \"Amanda Miller\",\n    \"phone\": \"555-555-5555\",\n    \"address_line1\": \"525 S Winchester Blvd\",\n    \"city_locality\": \"San Jose\",\n    \"state_province\": \"CA\",\n    \"postal_code\": \"95128\",\n    \"country_code\": \"US\",\n    \"address_residential_indicator\": \"yes\"\n  },\n  \"ship_from\": {\n    \"company_name\": \"Example Corp.\",\n    \"name\": \"John Doe\",\n    \"phone\": \"111-111-1111\",\n    \"address_line1\": \"4009 Marathon Blvd\",\n    \"address_line2\": \"Suite 300\",\n    \"city_locality\": \"Austin\",\n    \"state_province\": \"TX\",\n    \"postal_code\": \"78756\",\n    \"country_code\": \"US\",\n    \"address_residential_indicator\": \"no\"\n  },\n  \"warehouse_id\": null,\n  \"return_to\": {\n    \"company_name\": \"Example Corp.\",\n    \"name\": \"John Doe\",\n    \"phone\": \"111-111-1111\",\n    \"address_line1\": \"4009 Marathon Blvd\",\n    \"address_line2\": \"Suite 300\",\n    \"city_locality\": \"Austin\",\n    \"state_province\": \"TX\",\n    \"postal_code\": \"78756\",\n    \"country_code\": \"US\",\n    \"address_residential_indicator\": \"no\"\n  },\n  \"confirmation\": \"none\",\n  \"customs\": null,\n  \"advanced_options\": {\n    \"bill_to_account\": null,\n    \"bill_to_country_code\": null,\n    \"bill_to_party\": null,\n    \"bill_to_postal_code\": null,\n    \"contains_alcohol\": false,\n    \"custom_field1\": null,\n    \"custom_field2\": null,\n    \"custom_field3\": null,\n    \"non_machinable\": false,\n    \"saturday_delivery\": false,\n    \"delivered_duty_paid\": false,\n    \"use_ups_ground_freight_pricing\": true,\n    \"freight_class\": \"175\"\n  },\n  \"insurance_provider\": \"none\",\n  \"tags\": [],\n  \"packages\": [\n    {\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 20.00,\n        \"unit\": \"pound\"\n      },\n      \"dimensions\": {\n        \"unit\": \"inch\",\n        \"length\": 20.00,\n        \"width\": 20.00,\n        \"height\": 20.00\n      },\n      \"insured_value\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.00\n      },\n      \"label_messages\": {\n        \"reference1\": null,\n        \"reference2\": null,\n        \"reference3\": null\n      }\n    }\n  ],\n  \"total_weight\": {\n    \"value\": 20.00,\n    \"unit\": \"pound\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-label-for-ups-ground-freight","__idx":6},"children":["Create a Label for UPS Ground Freight"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Similar to rating a UPS Ground Freight shipment, a label requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_code"]}," property and then the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advanced_options"]}," object with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["freight_class"]}," property."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"service_code\": \"ups_ground_freight\",\n  \"advanced_options\": {\n    \"freight_class\": \"50\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-label-request--response","__idx":7},"children":["Example Label Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example includes the necessary values in a request to the labels endpoint."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\n    \"service_code\": \"ups_ground_freight\",\n    \"advanced_options\": {\n      \"freight_class\": \"150\"\n    },\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"address_line2\": \"Suite 300\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"no\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 20.0,\n          \"unit\": \"pound\"\n        },\n        \"dimensions\": {\n          \"unit\": \"inch\",\n          \"length\": 20.0,\n          \"width\": 20.0,\n          \"height\": 20.0\n        }\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-1021\",\n  \"status\": \"completed\",\n  \"shipment_id\": \"se-1001165\",\n  \"ship_date\": \"2019-07-29T05:00:00.000Z\",\n  \"created_at\": \"2019-07-29T13:33:10.169Z\",\n  \"shipment_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 176.86\n  },\n  \"insurance_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"rate_details\": [\n    {\n      \"rate_detail_type\": \"shipping\",\n      \"carrier_description\": null,\n      \"carrier_billing_code\": \"Base Rate\",\n      \"carrier_memo\": null,\n      \"amount\": {\n        \"currency\": \"usd\",\n        \"amount\": 176.86\n      },\n      \"billing_source\": \"Carrier\"\n    }\n  ],\n  \"tracking_number\": \"1ZR3890Y0395642846\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-3143\",\n  \"service_code\": \"ups_ground_freight\",\n  \"package_code\": \"package\",\n  \"voided\": false,\n  \"voided_at\": null,\n  \"label_format\": \"pdf\",\n  \"label_layout\": \"4x6\",\n  \"trackable\": true,\n  \"carrier_code\": \"ups\",\n  \"tracking_status\": \"in_transit\",\n  \"label_download\": {\n    \"href\": \"https://api.shipengine.com/v1/downloads/1/xG1ydsrzJkuRsG3VL_Talg/label-1021.pdf\"\n  },\n  \"form_download\": null,\n  \"insurance_claim\": null,\n  \"packages\": [\n    {\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 20.00,\n        \"unit\": \"pound\"\n      },\n      \"dimensions\": {\n        \"unit\": \"inch\",\n        \"length\": 20.00,\n        \"width\": 20.00,\n        \"height\": 20.00\n      },\n      \"insured_value\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.00\n      },\n      \"tracking_number\": \"1ZR3890Y0395642846\",\n      \"label_messages\": {\n        \"reference1\": null,\n        \"reference2\": null,\n        \"reference3\": null\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"UPS Ground Freight","id":"ups-ground-freight","depth":1},{"value":"UPS Ground Freight Unavailable in Batches","id":"ups-ground-freight-unavailable-in-batches","depth":3},{"value":"Understanding Freight Classifications (NMFC)","id":"understanding-freight-classifications-nmfc","depth":2},{"value":"Supported Freight Classes","id":"supported-freight-classes","depth":3},{"value":"Rating a UPS Ground Freight Shipment","id":"rating-a-ups-ground-freight-shipment","depth":2},{"value":"Example Rate Request & Response","id":"example-rate-request--response","depth":3},{"value":"Create a Label for UPS Ground Freight","id":"create-a-label-for-ups-ground-freight","depth":2},{"value":"Example Label Request & Response","id":"example-label-request--response","depth":3}],"frontmatter":{"seo":{"title":"UPS Ground Freight"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/shipping/ups-ground-freight","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}