--- title: "Retrieve a existing carrier selection." method: GET path: "/api/v1/deliveryexperience/shipment/{shipiumShipmentId}/carrierSelection/{carrierSelectionId}" tags: ["carrier-selection"] --- # Retrieve a existing carrier selection. `GET /api/v1/deliveryexperience/shipment/{shipiumShipmentId}/carrierSelection/{carrierSelectionId}` ## Path parameters - `shipiumShipmentId` string, required - `carrierSelectionId` string, required ## Query parameters - `includeCancelled` boolean ## Headers - `X-DELEGATED-PARTNER-ID` string ## Response `200` CarrierSelection retrieved. - CarrierSelection - `carrierSelectionId` string — Unique id of the carrier selection for later lookup. - `shipiumShipmentId` string — The unique identifier for this shipment. - `partnerShipmentId` string — The optional unique identifier that may be used for this shipment. - `shipiumTenantId` string — The shipium generated tenant ID. When present, this is used to indicate the tenant associated with the shipment. - `partnerTenantId` string — The partner provided tenant ID. When present, this is used to indicate the tenant associated with the shipment. - `costAdjustConfigId` string — If specified, this is the dynamic costing config applied for the carrier selection - `carrierDecision` CarrierSelectionDecision — Details of the carrier selection decision - `status` 'success' | 'uncosted' | 'no_decision' — Defines the result of the carrier selection call. Values returned will be success, or no_decision - `statusDetails` string — Details explaining the result status. Pertinent when the status is "no_decision". - `partnerId` string — Unique id of the partner. - `carrierAccountId` string — Unique id of the carrier account selected for shipping. - `serviceMethodUrn` string — Specific version of the service level of the shipping carrier selected - `serviceMethodIdentifier` string — The string used to identify the service method for this partner - `carrier` string — The carrier that was used for delivering the package to your customer. - `carrierServiceName` string — Name of the carrier service method selected. - `thirdPartyBilling` boolean — Indicates if the selected service method will be billed to a third party. - `includeEvaluatedServiceMethodsInResponse` boolean — Indicates if the partner passed in a field to expand carrier selection - `includeLineItemsInEvaluatedServiceMethods` boolean — When "true" a response will include line item information for the returned evaluated service methods, provided that includeEvaluatedServiceMethodsInResponse is also set to true. - `carrierEstimatedPriceDetails` CarrierSelectionPrice — Estimated cost of the carrier service selected. - `currencyCode` string — Currency which all price line items are stored in e.g. USD. - `shippingCost` number, float — Cost of shipment charged by the carrier. - `insuranceCost` number, float — Cost of insurance added to the shipment. - `accessorials` number, float — Costs added to the shipment outside the normal basics of dock to dock transportation such as special equipment required, lift gates, or non-commercial destinations. - `duty` number, float — Cost of duties added to the shipment. - `taxes` number, float — Cost of taxes added to the shipment - `totalCost` number, float — Total cost of the shipment - `adjustedLabelCost` number, float — Cost used for carrier selection adjusted based on limit minimums - `carrierCompareCost` number, float — Cost expected to be provided in the carrier response. not including custom adjustments or hidden surcharges - `carrierInvoiceCost` number, float — Expected cost that carrier will charge. - `operationalCost` number, float — Carrier invoice cost plus operational costs like injection line haul. - `serviceMethodName` string — Name of the carrier service method selected during the carrier selection process. - `carrierServiceMethodId` string — Maps to the unique internal Shipium ID which represents a carrier service method definition. - `ruleSetProcessingResultSummary` RuleSetProcessingResultSummary — Result of processing the applicable RuleSet if one was processed. - `result` 'selection_made' | 'no_selection' — Description of the result of the RuleSet processing. - `selectedCarrierServiceMethodIdentifiers` string[] — Ordered list of Service methods selecgted by the RuleSet processing if a selection was made. - `ruleMakingSelection` RuleIdentification — Rules that were active and in tenant scope but whose criteria did not match the shipment. - `ruleId` string - `ruleUrn` string - `name` string - `serviceMethodIdsAfterExecutingRule` string[] - `sequence` integer - `inactive` boolean - `rulesApplied` RuleIdentification[] — The Rule(s) that were applied in the order that they were executed. - `ruleId` string - `ruleUrn` string - `name` string - `serviceMethodIdsAfterExecutingRule` string[] - `sequence` integer - `inactive` boolean - `ruleSetUrn` string — Versioned identifier of the RuleSet processed. - `processingTimestamp` string, date-time — The timestamp at which the RuleSet was processed. - `effectiveShipDateTime` string, date-time — The earliest that a shipment can leave the FC/origin based on the shippedDateTime and the schedules for that FC/origin and the carriers. - `estimatedDeliveryDate` string, date-time — The date and time by when the package is estimated to be delivered to the customer in respect to a Desired Delivery Date. - `estimatedInjectionDateTime` string, date-time — The estimate date that the shipment will arrive at the injection site. - `carrierZoneId` string — The carrier zone that is being considered. - `injectionDetails` InjectionDetails — InjectionProfile and InjectionSite details - `requestInjectionProfileId` string — The partner can provide either partnerInjectionProfileId or shipiumInjectionProfileId in the request and this attribute records / indicates the injectionProfile identifier provided by the partner in the request. - `partnerInjectionProfileId` string — Unique to the partner asset ID that is provided by the partner to the injectionProfile. - `shipiumInjectionProfileId` string — InjectionProfile identifier. - `requestInjectionSiteId` string — The partner can provide either partnerInjectionSiteId or shipiumInjectionSiteId in the request and this attribute records / indicates the injectionSite identifier provided by the partner in the request. - `partnerInjectionSiteId` string — Unique to the partner asset ID that is provided by the partner to the injectionSite. - `shipiumInjectionSiteId` string — InjectionSite identifier - `injectionCostDetails` InjectionCostDetails — Injection cost details - `injectionLineItemRate` number, float — The amount of the rate modification - `injectionLineItemCurrencyCode` string — The currency that the rate is in. - `injectionRateModifier` InjectionRateModifier — The RateModifier to be applied if the service method is for Injection - `modifierType` 'flat' | 'percentage' — The type of the injection rate modifier. - `modifierValue` number, float — The value of the modification. - `effectiveDesiredDeliveryDate` string, date-time — The timestamp for the adjusted desired delivery date. This date includes all adjustments that Shipium has made to the requested desired delivery date. Shipium will use this dateTime for carrier selection. The timestamp must be a valid ISO 8601 timestamp. - `currencyCode` string — Currency in which all the rates for shipping carrier selection costs were calculated in. - `exddCompatibleFlag` boolean — Indicates if the confidence level of the TNT value used in the estimated delivery date calculation was above the threshold required for the service method to be considered for exact date delivery. This field is only set if the SDP ML model is the source of the TNT value - otherwise, this field will be null. - `carrierSelectionDateTime` string, date-time — ISO-8601 formatted date when the carrier selection decision was made. - `carrierSelectionExpiration` string, date-time — ISO-8601 formatted date defining the point in time when the carrier selection details expire and cannot be acted upon. - `laneMatch` LaneMatch — The matched lane for the carrier that was selected. This will be empty if nothing is configured for lanes. - `laneId` string — The laneId that was matched on and used. - `partnerLaneId` string — The lane sort match name that was configured on the lane. - `cancellationDateTime` string, date-time — The timestamp for when a carrier selection was cancelled. This field will default to null when the carrier selection is not cancelled. A carrier selection cannot be cancelled if it is associated with an active label - `currencyCode` string — Currency in which all the rates for shipping carrier selection costs were calculated in. ## Other responses - `404` — Unable to find Carrier Selection --- [API](https://skmtc.net/shipium/apis/shipium-api.md) · [All operations](https://skmtc.net/shipium/apis/shipium-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipium/shipium-api/revisions/7ef5dbd6a025/schema)