--- title: "Endpoint to retrieve all the orders from a Plan." method: GET path: "/api/v1/fe/plans/{planId}/orders" tags: ["plans"] --- # Endpoint to retrieve all the orders from a Plan. `GET /api/v1/fe/plans/{planId}/orders` ## Request - Base URL: `https://api.shipium.com` - URL: `https://api.shipium.com/api/v1/fe/plans/{planId}/orders` - Auth: OAuth 2 - Password - Token URL: `https://auth.shipium.com/oauth/token` scopes: `delivery-experience-service` - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `planId` string, required ## Response `200` List of orders from a plan. - FEOrder[] - `planId` string, required: Unique id of the plan generated by Shipium. - `orderId` string, required: Unique id of the order generated by Shipium. - `partnerOrderId` string, required: Partner provided ID for this order. - `currencyCode` 'chf' | 'usd' | 'not_set' | 'unknown', required: The currency code, in ISO-4217 format, represents the currency the order was purchased in. - `desiredDeliveryDate` string: The string representation of either an ISO-8601 date or a LocalDate: yyyy-mm-dd. The date or datetime the package is intended to arrive to the customer. This will be used to determine the most appropriate service method when generating a label - `desiredDeliveryDateOptions` FEDesiredDeliveryDateOptions: Options for how the system will use the desiredDeliveryDate - `exactDateDelivery` boolean: This will restrict carrier selection to only use service methods that we have a high chance of making it there on time. - `guaranteedDateDelivery` boolean: Instructs the carrier deliver the package on the date provided in desiredDeliveryDate. This will restrict carrier selection to service methods that can support exactDateDelivery - `upgradeCostDeltaMax` number, float: The upgrade amount we should be strict about ddd and exactDateDelivery calculations. - `currencyCode` string: The currency code associated with monetary values in this code block. Default: USD. This default occurs in the code block to not have this form populated for non DDD shipments. - `fulfillmentPreference` 'OnTime' | 'Consolidate' | 'Unknown': Controls which fulfillment strategy is prioritized when trying to meet the desiredDeliveryDate - `businessDaysOfTransit` integer: Indicates the number of business days from the ship time by when the shipment needs to be delivered. - `shipOption` string: A high-level shipping option shown to or selected by a customer. - `shippedDateTime` string, date-time: The timestamp for when you (or your fulfillment partner) shipped the product from your (or their) warehouse. The timestamp must be a valid ISO 8601 timestamp. - `destinationAddress` Address, required: Ship to address for the order. - `name` string: The name associated with the address. - `company` string: The company name for the address. - `street1` string: The first address line. - `street2` string: The second address line. - `city` string: The name of the city for the address. - `region` string: The name of the state or region for the address. - `countryCode` string, required: The ISO 3166-1 country code for the address. - `postalCode` string, required: A countryCode-appropriate postal code for the address. - `addressType` 'commercial' | 'residential': The type of location for this address. - `orderedDateTime` string, date-time, required: The timestamp for when the customer ordered the product. The timestamp must be a valid ISO 8601 timestamp. - `partnerReferenceIdentifier` string: Reference external identifier explicitly provided by the partner. Used for reporting purposes. - `partnerReferenceIdentifier2` string: Second reference external identifier explicitly provided by the partner. Used for reporting purposes. - `orderItemQuantities` FEOrderItem[], required: List of ordered items. - `quantity` integer, required: The number of units of this product. - `productId` string, required: Product identifier - `orderParams` Criteria, required: Parameters for customizing the planning behavior for the order. - `mustShipComplete` boolean: True if all order items must be planned for shipment. Default is false. - `proposedShipments` ProposedShipment[], required: Proposed shipment(s) from the owning plan that will ship order items to the customer destination address. - `proposedShipmentId` string, required: Unique identifier of the shipment. - `fulfillmentCenterId` string: Fulfillment center to ship from. - `fulfillmentContextId` string, required: Fulfillment context to ship from. - `fulfillmentContext` string: Alias for the fulfillment context to ship from. - `cost` CostInfo: Carrier, service method, and cost of proposed shipment out of fulfillment center. This field is populated if the caller has the authorities: CARRIER_SELECTION_API or FULFILLMENT_ENGINE_COST_SHARING - `carrier` string: Proposed carrier to ship package out of fulfillment center - `serviceMethod` string: Proposed carrier service method to use shipping package out of fulfillment center - `cost` number, float: Estimated to ship package out of fulfillment center - `performance` Performance: Calculated performance of the proposed shipment if available. - `effectiveShipDateTime` string, date-time: Calculation for the effective ship date time that a shipment will ship out. - `estimatedDeliveryDate` string, date-time: The date and time by when the package is estimated to be delivered to the customer. - `estimatedDeliveryDateLocal` string: A ISO-8601 date-time without a time-zone - `destinationTimezoneId` string - `destinationAddress` Address, required: Ship to address for the order. - `name` string: The name associated with the address. - `company` string: The company name for the address. - `street1` string: The first address line. - `street2` string: The second address line. - `city` string: The name of the city for the address. - `region` string: The name of the state or region for the address. - `countryCode` string, required: The ISO 3166-1 country code for the address. - `postalCode` string, required: A countryCode-appropriate postal code for the address. - `addressType` 'commercial' | 'residential': The type of location for this address. - `packagingType` FEPackagingType, required: Default packaging type definition when no packaging information is available at the time of a FE planner run. - `packagingTypeId` string, required: Packing type identifier to a V2 packaging asset in carrier selection. - `packagingMaterial` 'box' | 'envelope' | 'flat_pack' | 'unknown', required: The shipment packaging material. - `linearDimensions` LinearDimensions, required: Dimensions describing the size of the packaging. - `linearUnit` 'in' | 'cm': The unit that linear dimensions are provided in, either in for inches or cm for centimeters. - `length` number, float: The longest linear dimension (e.g. the longest side of a box or envelope). - `width` number, float: The second longest linear dimension (e.g. the second-longest side of a box of envelope. - `height` number, float: The least long linear dimension (e.g. the shortest side of a box or envelope. Note on envelopes: This height should represent the highest product you would reasonably put in this envelope before losing more than 10% of the length of the envelope in other dimensions. - `weight` Weight, required: The weight of this type of packaging empty. - `weightUnit` 'g' | 'kg' | 'oz' | 'lb': The unit that weight values are provided in. g for grams kg for kilograms oz for ounces lb for pounds - `weight` number, float: The value of the weight. - `maxContentWeight` Weight: The weight of this type of packaging empty. - `weightUnit` 'g' | 'kg' | 'oz' | 'lb': The unit that weight values are provided in. g for grams kg for kilograms oz for ounces lb for pounds - `weight` number, float: The value of the weight. - `urn` string - `packagingSizeName` string: Partner provided name for the packaging type. - `shipmentItems` ShipmentItem[], required: Items to ship. - `productId` string, required: Product identifier - `partnerOrderId` string, required: Partner provided ID for the order. - `linearDimensions` LinearDimensions: Dimensions describing the size of the packaging. - `linearUnit` 'in' | 'cm': The unit that linear dimensions are provided in, either in for inches or cm for centimeters. - `length` number, float: The longest linear dimension (e.g. the longest side of a box or envelope). - `width` number, float: The second longest linear dimension (e.g. the second-longest side of a box of envelope. - `height` number, float: The least long linear dimension (e.g. the shortest side of a box or envelope. Note on envelopes: This height should represent the highest product you would reasonably put in this envelope before losing more than 10% of the length of the envelope in other dimensions. - `weight` Weight: The weight of this type of packaging empty. - `weightUnit` 'g' | 'kg' | 'oz' | 'lb': The unit that weight values are provided in. g for grams kg for kilograms oz for ounces lb for pounds - `weight` number, float: The value of the weight. - `totalWeight` Weight: The weight of this type of packaging empty. - `weightUnit` 'g' | 'kg' | 'oz' | 'lb': The unit that weight values are provided in. g for grams kg for kilograms oz for ounces lb for pounds - `weight` number, float: The value of the weight. - `unfulfillableItems` UnfulfillableItem[], required: Order items not shipping in the owning plan. - `partnerOrderId` string, required: Partner provider order ID of the unfulfillable item. - `orderItem` FEOrderItem, required: List of ordered items. - `quantity` integer, required: The number of units of this product. - `productId` string, required: Product identifier - `reason` string, required: Reason the item could not be fulfilled. - `countUnfulfilled` integer, required - `shipmentTags` string[]: Free-form list of shipment tags for this order, echoed from the plan request. Matches the shipmentTags field on the Carrier Selection API request. ## Other responses - `400`: Invalid inputs were provided. ## Changes - **2026-11-03** `3edfc3693c7b`: 1 info - endpoint added [Operation history](https://skmtc.dev/shipium/apis/shipium-api/changes/api/v1/fe/plans/:planId/orders/get.md) --- [API](https://skmtc.dev/shipium/apis/shipium-api.md) - [All operations](https://skmtc.dev/shipium/apis/shipium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shipium/apis/shipium-api/revisions/3edfc3693c7b?raw)