{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipments/list","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipments/list","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipments/list","default":false,"active":true,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml","oas-apis/@shipstation-v1/openapi.yaml":"oas-apis/@shipstation-v1/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapi-code-sample","replay-openapi"]},"type":"markdown"},"seo":{"title":"List Shipments","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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"list-shipments","__idx":0},"children":["List Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtains a list of shipments that match the specified criteria."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["valid shipments with labels generated in ShipStation"]}," will be returned in the response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Orders that have been marked as ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Shipped"]}," either through the UI or the API will ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," appear as they are considered external shipments."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To include each shipment's associated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipmentItems"]}," in the response, be sure to set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includeShipmentItems"]}," parameter to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v1/openapi.yaml","operationId":"list_shipments","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"oas-apis/@shipstation-v1/openapi.yaml","operationId":"list_shipments","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":1},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/shipments/create-label"},"children":["Create Shipment Label"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/shipments/get-rates"},"children":["Get Rates"]}]}]}]},"headings":[{"value":"List Shipments","id":"list-shipments","depth":1},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"seo":{"title":"List Shipments"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipstation-v1/docs/shipments/list","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}