{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/downloading","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/downloading","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/downloading","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Downloading a Label","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":"downloading-a-label","__idx":0},"children":["Downloading a Label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You have two options for downloading labels you've created with ShipStation API:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download via URL"]},": Make an HTTP request to download the label in your desired file type from the URLs provided in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," object from the create label response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inline labels"]},": If you only intend to download the label in a single format and you know ahead of time which format that is, you can optimize your workflow by eliminating the extra HTTP request to download the label. Instead, you can use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_format"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download_type"]}," fields to include the full label in the API response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-1-download-via-url","__idx":1},"children":["Option 1: Download via URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, ShipStation API provides URLs to download labels in multiple formats. The URLs will remain valid for 90 days. If your workflow requires the ability to access these URLs after 90 days, we recommend storing the label images locally."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-test-147980607\",\n  \"shipment_id\": \"se-41783999\",\n  \"label_format\": \"pdf\",\n  \"label_layout\": \"4x6\",\n  \"label_download\": {\n    \"pdf\": \"https://api.shipengine.com/v1/downloads/6/3TidbpFJOkm4RmWzQ-woyQ/label-147980607.pdf\",\n    \"png\": \"https://api.shipengine.com/v1/downloads/6/3TidbpFJOkm4RmWzQ-woyQ/label-147980607.png\",\n    \"zpl\": \"https://api.shipengine.com/v1/downloads/6/3TidbpFJOkm4RmWzQ-woyQ/label-147980607.zpl\",\n    \"href\": \"https://api.shipengine.com/v1/downloads/6/3TidbpFJOkm4RmWzQ-woyQ/label-147980607.pdf\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"public-urls","__idx":2},"children":["Public URLs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API generates a unique authentication token for each label so it can be securely shared and downloaded by your users without exposing your private API key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can access the label on the command line using curl:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -O https://api.shipengine.com/v1/downloads/6/3TidbpFJOkm4RmWzQ-woyQ/label-147980607.png\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-rotation","__idx":3},"children":["Label Rotation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can rotate the label ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["90"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["180"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["270"]}," degrees by appending ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?rotation=:value"]}," to the URL."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supported for ZPL and PDF formats."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rotation"]}," value for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zpl"]}," labels are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," (default) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["180"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rotation"]}," values for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}," labels are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," (default), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["90"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["180"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["270"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can view the rotated image in your web browser using this URL or download it on the command line using curl:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -O http://api.shipengine.com/v1/downloads/0/ZRl-cd0SiUykIRo7ukxGfw/label-1042854.pdf?rotation=180\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TIP:"]}," ","You can chain the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["download"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rotation"]}," parameters together using an ampersand to rotate the image and download it directly from your browser - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rotation=180&download=0"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-2-inline-label","__idx":4},"children":["Option 2: Inline Label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With this method, you'll use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_format"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download_type"]}," properties to include the full label in the API response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"about-the-inline-label-properties","__idx":5},"children":["About the Inline Label Properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Label Format:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PDF: The Adobe PDF format. This is the default if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_format"]}," is unspecified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PNG: A PNG (portable network graphics) image file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ZPL: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://km.zebra.com/kb/index?page=content&id=SO8476"},"children":["Zebra Programming Language"]}," format, which is useful for printing with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.zebra.com/us/en/products/printers.html"},"children":["Zebra Printer"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Label Layout:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["4x6 : 4 inch by 6 inch label. This is the default if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout"]}," is unspecified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["letter: US Letter size (8.5 inches by 11 inches)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Label Download Type:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]},": You will receive URLs to download the label in separate HTTP requests. The URLs will remain valid for 90 days. This is the default if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download_type"]}," is unspecified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inline"]},": You will receive a single, Base64-encoded label as part of the response. No need for a second request to download the label."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-inline-request--response","__idx":6},"children":["Example Inline Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example demonstrates how to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_format"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download_type"]}," to request a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4x6"]}," PNG label to be included in the API response."]},{"$$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\nContent-Length: 1054\n\n{\n  \"label_format\": \"png\",\n  \"label_layout\": \"4x6\",\n  \"label_download_type\": \"inline\",\n  \"shipment\": {\n    \"service_code\": \"usps_priority_mail\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"email\": \"recipient@example.com\",\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      \"email\": \"sender@example.com\",\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    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 1.0,\n          \"unit\": \"ounce\"\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":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download.href"]}," field in the response will be a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Data_URI_scheme"},"children":["Data URI"]},", which is a special kind of URL that includes the data inline."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data URI has four parts: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scheme"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["media type"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["encoding type"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Examples"},"children":["Examples"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scheme"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This just identifies the URL as a Data URI as opposed to other schemes like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http:"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ftp:"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Media Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/pdf"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["image/png"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/zpl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the label's ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Media_type"},"children":["MIME Type"]},", which corresponds to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_format"]}," that you specified when creating the label."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Encoding Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base64"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ShipStation API always encodes inline labels in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Base64"},"children":["Base64 format"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A very long Base64 string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the actual Base64-encoded label data. Most programming languages include a Base64 decoder as part of their standard library. If your language doesn't, then you may need to use a third-party Base64 decoder."]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-test-147980607\",\n  \"shipment_id\": \"se-41783999\",\n  \"label_format\": \"png\",\n  \"label_layout\": \"4x6\",\n  \"label_download\": {\n    \"href\": \"data:image/png;base64,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\"\n  }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Downloading a Label","id":"downloading-a-label","depth":1},{"value":"Option 1: Download via URL","id":"option-1-download-via-url","depth":2},{"value":"Public URLs","id":"public-urls","depth":3},{"value":"Label Rotation","id":"label-rotation","depth":3},{"value":"Option 2: Inline Label","id":"option-2-inline-label","depth":2},{"value":"About the Inline Label Properties","id":"about-the-inline-label-properties","depth":3},{"value":"Example Inline Request & Response","id":"example-inline-request--response","depth":3}],"frontmatter":{"seo":{"title":"Downloading a Label"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/downloading","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}