{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipping/carrier-packaging","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/carrier-packaging","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/carrier-packaging","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Carrier Packaging","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":"carrier-packaging","__idx":0},"children":["Carrier Packaging"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most carriers support their own package types, each with a specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," that you define in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object for a shipment. While the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," properties are not required by ShipStation API, most carriers will require at least the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," to successfully return a label. Additionally, the carrier package you use can affect things like your rate (e.g., a USPS Flat Rate box will have a different rate than a generic package)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To see what types of packages your carrier supports and the associated properties, you can use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carrier-packages"},"children":["list carrier packages request"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Carrier packaging is distinct from using ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/custom-package-types"},"children":["custom package types"]},", which are custom packages where you define the package properties in advance, including dimensions, and only add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":1},"children":["Example Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["create label"]}," example uses the USPS Priority Mail service with a medium flat rate box package type. In the case of flat rate boxes, you will declare package weight (to ensure the shipment does not exceed the flat rate maximum) but would not declare package dimensions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/labels/"]}]},{"$$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    \"packages\": [\n      {\n        \"package_code\": \"medium_flat_rate_box\",\n        \"weight\": {\n          \"value\": 9.6,\n          \"unit\": \"ounce\"\n        }\n      }\n    ],\n    \"service_code\": \"usps_priority_mail\",\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    \"confirmation\": \"none\",\n    \"insurance_provider\": \"none\"\n  }\n}\n\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the creat label response, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," property will be a property in both the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}," object and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object. In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/create-a-shipment"},"children":["create shipment"]}," response, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_code"]}," property will be in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object only."]}]},"headings":[{"value":"Carrier Packaging","id":"carrier-packaging","depth":1},{"value":"Example Request","id":"example-request","depth":2}],"frontmatter":{"seo":{"title":"Carrier Packaging"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/shipping/carrier-packaging","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}