{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/paperless","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/paperless","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/paperless","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Paperless Labels","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":"paperless-labels","__idx":0},"children":["Paperless Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paperless shipping (also called labelless shipping) allows you to send a shipment without printing a traditional label. Paperless services are quickly becoming more common and are an excellent way to serve senders that do not have a printer available."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A common use case for paperless services is for returns. Paperless returns help customers by not requiring the printing of a label. Instead, the customer can take their barcode or handoff code to the carrier, who will label the shipment as needed. This also allows merchants to avoid the label-in-a-box strategy where the pre-printed return label might not ever be used."]},{"$$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":"not-supported-by-all-carriers-or-services","__idx":1},"children":["Not supported by all carriers or services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only some carriers and services support the paperless capability. If you are unsure if your desired carrier/service includes the paperless options, review the carrier guide."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For details on creating USPS paperless labels, see our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/stamps-usps-guide"},"children":["Stamps.com (USPS) Carrier Guide"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"paperless-methods","__idx":2},"children":["Paperless Methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When your label request specifies the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["paperless display schema"]},", the carrier will typically return a handoff code, barcode (for example, a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/QR_code"},"children":["QR code"]},"), instructions for next steps, or a mix of all of these."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handoff code"]},": Depending on the carrier, the handoff code can be written on the package, provided to a member of staff at drop-off point, or entered via pin pad into a dedicated mechine like a package locker or label printer at a drop-off point."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Barcode"]}," (ex: QR code): The code is scanned at the drop-off point. This may be by a staff member who will accept the package but can also apply to drop-off lockers using in-built scanners."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some carriers don't generate a barcode at all. Instead, the carrier generates the label and brings it when they collect the package."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-a-paperless-label","__idx":3},"children":["Request a Paperless Label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request a paperless label, include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display_scheme"]}," property in your label request with one of the following values:"]},{"$$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":"Value"},"children":["Value"]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default. Requests only the traditional label from the carrier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests only the paperless label from the carrier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_and_paperless"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests both a traditional label and the paperless label from the carrier."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--response","__idx":4},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display_scheme"]}," property to your purchase label request. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["This example uses a \"dummy\" carrier and service and may not include all properties needed for a live shipment"]},"."]},{"$$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    \"label_layout\":\"4x6\",\n    \"display_scheme\": \"paperless\",\n    \"shipment\": {\n        \"carrier_id\": \"se-123456\",\n        \"service_code\": \"dummy_carrier_premium_same_day\",\n        \"ship_from\": {\n            \"name\": \"Dade Murphy\",\n            \"phone\": \"512-555-5555\",\n            \"email\": \"recipient@example.com\",\n            \"company_name\": \"Zero Cool\",\n            \"address_line1\": \"123 Main St\",\n            \"address_line2\": \"Apt 305\",\n            \"city_locality\": \"Austin\",\n            \"state_province\": \"TX\",\n            \"postal_code\": \"78731\",\n            \"country_code\": \"US\"\n        },\n        \"ship_to\": {\n            \"name\": \"Kate Libby\",\n            \"phone\": \"714-444-5555\",\n            \"email\": \"sender@example.com\",\n            \"company_name\": \"The Garbage file\",\n            \"address_line1\": \"2321 Grand Ave\",\n            \"address_line2\": \"\",\n            \"city_locality\": \"Leander\",\n            \"state_province\": \"TX\",\n            \"postal_code\": \"78641\",\n            \"country_code\": \"US\",\n            \"email\": \"acidburn@email.com\"\n        },\n        \"packages\": [\n            {\n                \"weight\": {\n                    \"value\": 1,\n                    \"unit\": \"pound\"\n                },\n                \"dimensions\": {\n                    \"unit\": \"inch\",\n                    \"length\": 1,\n                    \"width\": 2,\n                    \"height\": 3\n                },\n                \"label_messages\": {\n                    \"reference1\": \"BillingReference1\",\n                    \"reference2\": \"BillingReference2\"\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":["For paperless services, the recommended way to consume the paperless data is via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless_download"]}," object, which will always be present when one of the paperless schema is set in the request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please note that, for backward compatibility reasons, ShipStation API will also populate the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," object with links to a document that contains a rasterized representation of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless_download"]}," where all parameters are merged together into a single document (for example, a barcode, handoff code, or instructions)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n\t{\n  \"label_id\": \"se-012345\",\n  \"status\": \"completed\",\n  \"shipment_id\": \"se-1111111\",\n  \"ship_date\": \"2024-04-10T07:00:00Z\",\n  \"created_at\": \"2024-04-10T09:58:34.7964037Z\",\n  \"shipment_cost\": {\n      \"currency\": \"usd\",\n      \"amount\": 34.0\n  },\n  \"insurance_cost\": {\n      \"currency\": \"usd\",\n      \"amount\": 0.0\n  },\n  \"tracking_number\": \"US.US.20240410.1712743114912.1\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-123456\",\n  \"service_code\": \"dummy_carrier_premium_same_day\",\n  \"package_code\": \"package\",\n  \"voided\": false,\n  \"label_format\": \"pdf\",\n  \"display_scheme\": \"paperless\",\n  \"label_layout\": \"4x6\",\n  \"trackable\": true,\n  \"carrier_code\": \"apicode-dummy-carrier\",\n  \"tracking_status\": \"in_transit\",\n  \"label_download\": {\n      \"pdf\": \"https://api.shipengine.com/v1/downloads/8/9FCweYLJK0mEabBvlOBRIQ/label-107205664.pdf\",\n      \"png\": \"https://api.shipengine.com/v1/downloads/8/9FCweYLJK0mEabBvlOBRIQ/label-107205664.png\",\n      \"zpl\": \"https://api.shipengine.com/v1/downloads/8/9FCweYLJK0mEabBvlOBRIQ/label-107205664.zpl\",\n      \"href\": \"https://api.shipengine.com/v1/downloads/8/9FCweYLJK0mEabBvlOBRIQ/label-107205664.pdf\"\n  },\n  \"paperless_download\": {\n      \"href\": \"https://api.shipengine.com/v1/downloads/8/EXyUADSveUiaOqTMekdPrw/paperlesslabel-107205664.png\",\n      \"instructions\": \"Leave with front desk\",\n      \"handoff_code\": \"1234\"\n  },\n  \"packages\": [\n      {\n          \"package_id\": 68764917,\n          \"package_code\": \"package\",\n          \"weight\": {\n              \"value\": 1.00,\n              \"unit\": \"pound\"\n          },\n          \"dimensions\": {\n              \"unit\": \"inch\",\n              \"length\": 1.00,\n              \"width\": 2.00,\n              \"height\": 3.00\n          },\n          \"insured_value\": {\n              \"currency\": \"usd\",\n              \"amount\": 0.00\n          },\n          \"tracking_number\": \"US.US.20240410.1712743114912.1\",\n          \"label_download\": {\n              \"pdf\": \"https://api.shipengine.com/v1/downloads/8/OoTqlqXKxUu1fM0lNlmPwg/labelpackage-68764917.pdf\",\n              \"png\": \"https://api.shipengine.com/v1/downloads/8/OoTqlqXKxUu1fM0lNlmPwg/labelpackage-68764917.png\",\n              \"zpl\": \"https://api.shipengine.com/v1/downloads/8/OoTqlqXKxUu1fM0lNlmPwg/labelpackage-68764917.zpl\"\n          },\n          \"paperless_download\": {\n              \"href\": \"https://api.shipengine.com/v1/downloads/8/_HkHkeoORkqih1MVIHx5cQ/paperlesslabelpackage-68764917.png\",\n              \"instructions\": \"Leave with front desk\",\n              \"handoff_code\": \"1234\"\n          },\n          \"label_messages\": {\n              \"reference1\": \"BillingReference1\",\n              \"reference2\": \"BillingReference2\"\n          },\n          \"sequence\": 1,\n          \"alternative_identifiers\": [],\n          \"has_label_documents\": true,\n          \"has_form_documents\": false,\n          \"has_qr_code_documents\": true,\n          \"has_paperless_label_documents\": true\n      }\n  ],\n  \"charge_event\": \"carrier_default\",\n  \"alternative_identifiers\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are a few things to note about the response:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless_download"]}," object includes three parameters:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["href"]},": a link to the document returned by the carrier (typically a barcode)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["instructions"]},": the instructions provided by the carrier to describe what to do with the output. For example, \"Scan the QR code at the carrier locker\" or \"Use the pin pad to enter the handoff code\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["handoff_code"]},": the code used to hand off the package to the carrier (often entered via pin pad on a package locker, but can also be a code to provide staff when picked up from a location or at a drop off point)."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Certain carriers may not include all of these parameters. If a carrier does not include the parameter, it will not be present in the response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless_download"]}," object is shown at both the shipment level and the package level. Where this object is returned for your specific use case will depend on which carrier you are using."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-barcode","__idx":5},"children":["Example Barcode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here is an example of the rasterized representation from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/paperless_rasterized.e4d8e9d04179df7098a1a25eaf2530594ba53a11a3ac2cfa510eda2e6e0aa16e.2b580f94.png","alt":"Example QR code with handoff code"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"customer-communication","__idx":6},"children":["Customer Communication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using paperless labels might be a new experience for your cusomters. You may want to send email with the barcode image to help educate your customer on what they need to do to ship their package, including locating drop-off locations or how to use the barcode to hand over the package to the carrier."]}]},"headings":[{"value":"Paperless Labels","id":"paperless-labels","depth":1},{"value":"Not supported by all carriers or services","id":"not-supported-by-all-carriers-or-services","depth":3},{"value":"Paperless Methods","id":"paperless-methods","depth":2},{"value":"Request a Paperless Label","id":"request-a-paperless-label","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":3},{"value":"Example Barcode","id":"example-barcode","depth":2},{"value":"Customer Communication","id":"customer-communication","depth":2}],"frontmatter":{"seo":{"title":"Paperless Labels"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/paperless","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}