{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipping/ship-dates","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/ship-dates","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/ship-dates","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Ship Dates","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":"ship-dates","__idx":0},"children":["Ship Dates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]}," property in your shipment objects to specify the date the shipment will be shipped. By default, if no ship date is specified, ShipStation API assumes the ship date is the same day you created the shipment or label. ShipStation API will take the day of week into consideration. For example, if the carrier does not operate on Sundays, then the package ship date will be set to Monday instead."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specifying the ship date for a label can help you to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/pickups"},"children":["schedule a pickup"]},", receive more accurate ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["rates"]},", and importantly, enable you to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["create manifests"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]}," property uses the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":["ISO 8601 standard format"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TIP:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]}," is regarded strictly as a date and passes to the carrier as such. Best practice is to set the date to when the warehouse plans to actually hand over the package to the carrier. If that is not the same day you created the shipment or label, add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_date"]}," property to your request and set it to the desired date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-label-request--response","__idx":2},"children":["Example Label Request & 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\n\n{\n  \"shipment\": {\n    \"service_code\": \"usps_priority_mail\",\n    \"ship_date\": \"2024-09-23T00:00:00.000\",\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\": 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":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-test-41860047\",\n  \"status\": \"processing\",\n  \"shipment_id\": \"se-41860047\",\n  \"ship_date\": \"2024-09-23T00:00:00.000\",\n  \"created_at\": \"2024-09-21T15:00:00.000\",\n  \"shipment_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"insurance_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"tracking_number\": \"9999999999999\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-0\",\n  \"service_code\": \"usps_priority_mail\",\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\": \"stamps_com\",\n  \"tracking_status\": \"unknown\",\n  \"label_download\": {\n    \"pdf\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf\",\n    \"png\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.png\",\n    \"zpl\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.zpl\",\n    \"href\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf\"\n  },\n  \"form_download\": null,\n  \"insurance_claim\": null\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Ship Dates","id":"ship-dates","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Example Label Request & Response","id":"example-label-request--response","depth":2}],"frontmatter":{"seo":{"title":"Ship Dates"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/shipping/ship-dates","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}