{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/voiding","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/voiding","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/voiding","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Void 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":"void-a-label","__idx":0},"children":["Void a Label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under certain circumstances, you may need to void a label you have created. For example, a customer cancels a shipment or a label was created incorrectly. Another common reason to void a label is for unused ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/returns"},"children":["return labels"]}," that are charged on creation -- you will need to void that label to get a refund for it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," to identify which label you would like to void. The void process is similar for any label but the refund process may differ depending on the carrier."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT:"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"labels-cannot-be-un-voided","__idx":1},"children":["Labels Cannot Be Un-Voided!"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a label is voided it cannot be ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["unvoided"]},". However, you can create a new label for that shipment if needed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":2},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You will need the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," for the label you wish to void. You can get your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["create a shipping label"]}," response, or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-labels"},"children":["list labels"]}," to find a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_id"]}," based on query parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The carrier must support voiding label. If you are unsure if your carrier supports this action, contact them directly to find out their label voiding policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The label must be within the carrier's allowed void timeframe. If you are uncertain about your carrier's allowed timeframe, check their void and refund policies for specific deadline details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":3},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT /v1/labels/:label_id/void"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /v1/labels/se-421351/void HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response body will include two items:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A true/false boolean value to show if the void request was ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["approved"]},", and"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A message from the carrier. The message value will vary depending on the carrier used to create the label."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"approved\": true,\n  \"message\": \"Request for refund submitted. This label has been voided.\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refunds","__idx":4},"children":["Refunds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a voided label to qualify for a refund the label must be unused. This means that the label was not picked up or scanned by the carrier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any additional refund requirements and restrictions to the process of refunding a label will depend upon the policy of the carrier from whom the label was originally purchased."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shipstation-carriers","__idx":5},"children":["ShipStation Carriers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must void the label within a certain number of days after generating the label:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["USPS = 28 days"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UPS and other carriers = 30 days"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In most cases, the refund will be instantly refunded to your ShipStation API account balance. However, in some cases the refund can take up to 28 days to apply to the balance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"stampscom-or-endicia-usps-label-refunds","__idx":6},"children":["Stamps.com or Endicia USPS Label Refunds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To qualify for electronic reimbursement, the refund must be requested within a certain number of days after generating the label:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Stamps.com = 28 days"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Endicia = 30 days"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"post-billed-carrier-refunds","__idx":7},"children":["Post-Billed Carrier Refunds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Post-billed carrier accounts, like UPS and FedEx, do not charge for shipping labels that are not used and scanned into the carrier's system. Therefore, no refunds need to be applied to your account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Voiding labels for a post-billed carrier is not necessary if the labels are unscanned. However, you can still void labels for these carriers to help with your reporting if desired."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"denied-requests","__idx":8},"children":["Denied Requests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your voide request is denied, please refer to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," returned in the response. You can always contact support to figure out why you are unable to void a label."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Possible reasons a carrier may deny a void label request include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The label is too old to be voided."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The label has been scanned in by the carrier already."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The label has left the originating facility and is already en route to the destination."]}]}]},"headings":[{"value":"Void a Label","id":"void-a-label","depth":1},{"value":"Labels Cannot Be Un-Voided!","id":"labels-cannot-be-un-voided","depth":3},{"value":"Requirements","id":"requirements","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2},{"value":"Refunds","id":"refunds","depth":2},{"value":"ShipStation Carriers","id":"shipstation-carriers","depth":3},{"value":"Stamps.com or Endicia USPS Label Refunds","id":"stampscom-or-endicia-usps-label-refunds","depth":3},{"value":"Post-Billed Carrier Refunds","id":"post-billed-carrier-refunds","depth":3},{"value":"Denied Requests","id":"denied-requests","depth":2}],"frontmatter":{"seo":{"title":"Void a Label"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/voiding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}