--- title: "Changes to Get shipment by external id" method: GET path: "/v2/shipments/external_shipment_id/{external_shipment_id}" --- # Changes to Get shipment by external id `GET /v2/shipments/external_shipment_id/{external_shipment_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 11 of 30 revisions. - **2026-10-22** `4e29670aa28d`: 6 warning, 1 info - **2026-10-16** `bf3618aaf7e1`: 106 breaking, 13 info - **2026-10-13** `5bf6dc8ed400`: 1 info - **2026-10-09** `934f5935dbea`: 13 breaking, 24 warning, 64 info - **2026-09-09** `dc74a6387377`: 1 info - **2026-09-05** `17802d3fbe61`: 2 warning - **2026-09-04** `03ca91027c15`: 1 info - **2026-09-03** `cc0116dfedb6`: 1 info - **2026-09-02** `0e61ae174690`: 1 info - **2026-08-19** `13c58f90de0b`: 1 warning - **2026-08-15** `e9b68942091c`: 12 warning ## Changes - **2026-10-22** `4e29670aa28d`: 6 warning, 1 info - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `404` - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `404` - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `400` - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `404` - added `subschema #2: shipment_sales_order_fields` to the `allOf[subschema #1: shipment]/` response property `allOf` list for the response status `200` - **2026-10-16** `bf3618aaf7e1`: 106 breaking, 13 info - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/additional_handling` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/ancillary_endorsements_option` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/bill_to_account` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/bill_to_postal_code` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field1` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field2` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/custom_field3` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/freight_class` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/movement_indicator` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/return_pickup_attempts` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/shipper_release` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/use_ups_ground_freight_pricing` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/assigned_user` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/comparison_rate_type` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/deliver_by_date` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/display_scheme` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/external_order_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/external_shipment_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/hold_until_date` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/internal_notes` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/is_return` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/allocation_status` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/asin` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/bundle_sku` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/external_order_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/external_order_item_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/fullfilment_sku` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/image_url` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/inventory_location` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/item_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/product_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/sales_order_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/sales_order_item_id` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/shipping_amount` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/sku` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/tax_amount` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/unit_price` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/upc` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/notes_for_gift` became nullable for the status `200` - the response property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/notes_from_buyer` became nullable for the status `200` - …79 more - **2026-10-13** `5bf6dc8ed400`: 1 info - the `insured_value` response's property default value changed from `{"currency":"usd","amount":0}` to `{"currency":"usd","amount":0}` for the status `200` - **2026-10-09** `934f5935dbea`: 13 breaking, 24 warning, 64 info - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids/items/` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/allOf[subschema #1: importer_of_records]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/packages/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/ship_from/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/tags/items/` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/tax_identifiers/items/` response's property type changed from no type to `object` for status `200` - the `errors/items/` response's property type changed from no type to `object` for status `400` - the `errors/items/` response's property type changed from no type to `object` for status `404` - added the new `amazon_ca` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `amazon_us` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `any` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `brightpearl` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `cash` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `cash_equivalent` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `channel_advisor` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `cratejoy` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `ebay` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `etsy` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `groupon_goods` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `jane` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `magento` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `none` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200` - added the new `paypal` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `seller_active` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `shopify` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `squarespace` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `stitch_labs` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `three_dcart` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `tophatter` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `volusion` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `walmart` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the new `woo_commerce` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200` - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/allocation_status` to the response with the `200` status - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/asin` to the response with the `200` status - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/bundle_sku` to the response with the `200` status - …61 more - **2026-09-09** `dc74a6387377`: 1 info - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids` to the response with the `200` status - **2026-09-05** `17802d3fbe61`: 2 warning - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - **2026-09-04** `03ca91027c15`: 1 info - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents` to the response with the `200` status - **2026-09-03** `cc0116dfedb6`: 1 info - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes` to the response with the `200` status - **2026-09-02** `0e61ae174690`: 1 info - added the optional property `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim` to the response with the `200` status - **2026-08-19** `13c58f90de0b`: 1 warning - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200` - **2026-08-15** `e9b68942091c`: 12 warning - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400` - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `404` --- [Operation](https://skmtc.dev/shipstation/apis/shipstation-api-v2/docs/v2/shipments/external_shipment_id/:external_shipment_id/get.md) - [API](https://skmtc.dev/shipstation/apis/shipstation-api-v2.md) - [Page](https://skmtc.dev/shipstation/apis/shipstation-api-v2/changes/v2/shipments/external_shipment_id/:external_shipment_id/get)