Get started

To use the Carrier and Method Selection API, you must first set up your account to use Shipium's Carrier and Method Selection service. Information about carrier and method selection within the Shipium platform and setting up your organization's account to use the service can be found in the Carrier and Method Selection documentation.

The rest of this document provides instructions for using the API.

Determine carrier and ship method with the Carrier and Method Selection API

The Shipium Carrier and Method Selection API assumes you're using one of the authentication mechanisms detailed in our authentication documentation. The endpoint for Carrier and Method Selection API calls is included in the table below.

API type	API endpoint
POST	`https://api.shipium.com/api/v1/deliveryexperience/shipment/{shipiumShipmentId}/carrierSelection`

🔐
Authentication for API Calls
In the cURL example on this page, the environment variable AUTHSTRING is used to handle authorization. The recipe below shows how to set it correctly for both API Key and OAuth users.

Authenticating for Curl

Open Recipe

Example cURL call

This example shows a request to run the carrier selection process on an existing shipment:

curl --request POST \
  --url https://api.shipium.com/api/v1/deliveryexperience/shipment/{shipiumShipmentId}/carrierSelection \
  --header 'accept: application/json' \
  --header $AUTHSTRING \
  --header 'content-type: application/json' \
  --data 'INSERT REQUEST BODY FROM BELOW'

Example request body

The following fields should be included in your JSON request.

{
  "currencyCode": "usd",
  "shippedDateTime": "2024-03-21T17:29:51.571Z",
  "packagingType": {
    "packagingMaterial": "box",
    "packagingSizeName": "13x12x10 box",
    "packagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
    "linearDimensions": {
      "linearUnit": "in",
      "length": 13,
      "width": 12,
      "height": 10
    },
    "packagingWeight": {
      "weightUnit": "lb",
      "weight": 50
    }
  },
  "asOfDate": "2024-03-21T17:29:51.571Z",
  "includeEvaluatedServiceMethodsInResponse": true,
  "includeLineItemsInEvaluatedServiceMethods": true,
  "includeInjectionProfiles": true,
  "injectionParameters": [
    {
      "injectionProfileId": "0c3bdcfd-765b-4084-954e-76aa59dbd41d",
      "injectionSiteId": "3feb958c-414e-49f4-b15b-68f8f1cd02df"
    }
  ],
  "testMode": true
}

Example response body

{
  "carrierSelectionId": "1c17e8e3-24a6-452c-b85b-b319bebdb9f9",
  "shipiumShipmentId": "e117a666-78ea-425d-a78a-6ffee127b6e3",
  "partnerShipmentId": "shipment123",
  "shipiumTenantId": "ec93ca14-e85d-4a29-964e-9e55117b21c6",
  "partnerTenantId": "tenant123",
  "carrierDecision": {
    "status": "success",
    "statusDetails": "success",
    "partnerId": "56fb8f99-925a-4c62-af23-68d9e68171f8",
    "carrierAccountId": "ba9258de-4f59-4ecc-81bc-773b25c6306d",
    "serviceMethodIdentifier": "1f19ca28-9798-42b2-9e8c-f9c3a72c9bab:dXBzbWktcGFyY2VsLXNlbGVjdC1zZXJ2aWNlLW1ldGhvZDo6NDNjYTI3ZDctZmUzNi00YjI1LTk4MDAtYTdmMTE2ZDIyMTQxOjdiODExNzA0LTlhMTYtNGQzYi1iODQ5LTQzYzcyNzk0MTVhYzpmZTFlMjg1Mi1kNTBiLTQ5OGQtOGIxMC05MGJiMWM5ODFjZTA6dXBzbWk6NWExZWE3MjgtNGJhMi00Y2M2LTg5MmMtMWYxMjJmMzUwNzc1Ojo",
    "carrier": "upsmi",
    "carrierServiceName": "UPS Mail Innovations Parcel Select",
    "thirdPartyBilling": true,
    "includeEvaluatedServiceMethodsInResponse": true,
    "includeLineItemsInEvaluatedServiceMethods": true,
    "carrierEstimatedPriceDetails": {
      "currencyCode": "usd",
      "shippingCost": 0,
      "insuranceCost": 0,
      "accessorials": 0,
      "duty": 0,
      "taxes": 0,
      "totalCost": 0,
      "adjustedLabelCost": 0,
      "carrierCompareCost": 0,
      "carrierInvoiceCost": 0,
      "operationalCost": 0
    },
    "serviceMethodName": "UPS Mail Innovations Parcel Select",
    "carrierServiceMethodId": "upsmi-parcel-select-service-method",
    "ruleSetProcessingResultSummary": {
      "result": "selection_made",
      "selectedCarrierServiceMethodIdentifiers": [
        "upsmi-parcel-select-service-method"
      ],
      "ruleMakingSelection": {
        "ruleId": "c86a6865-da6a-48b2-be27-1e910b3127f5",
        "ruleUrn": "61ec67e9-8d54-4285-ab4d-f7d599ed968c",
        "name": "rule123"
      },
      "ruleSetUrn": "6c3b0780-1d66-4254-ba6d-060264be8873",
      "processingTimestamp": "2024-03-21T17:29:51.621Z"
    },
    "details": {
      "requestParams": {
        "currencyCode": "usd",
        "shippedDateTime": "2024-03-21T17:29:51.621Z",
        "packagingType": {
          "packagingMaterial": "box",
          "packagingSizeName": "13x12x10 box",
          "packagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
          "linearDimensions": {
            "linearUnit": "in",
            "length": 13,
            "width": 12,
            "height": 10
          },
          "packagingWeight": {
            "weightUnit": "lb",
            "weight": 50
          }
        },
        "asOfDate": "2024-03-21T17:29:51.621Z",
        "includeEvaluatedServiceMethodsInResponse": true,
        "includeInjectionProfiles": true,
        "injectionParameters": [
          {
            "injectionProfileId": "5c9f0961-1fe7-43d4-b314-664681c032a5",
            "injectionSiteId": "f4800e9e-eb9f-43c0-baa7-8c04dc971c6f"
          }
        ],
        "testMode": true,
      },
      "availableServiceMethods": [
        {
          "partnerId": "f657deeb-647b-4625-910b-53ea2c5e1458",
          "carrierAccountId": "f887c2d0-c524-4dc8-a4c2-6c3c08f0c120",
          "carrierSettingsId": "427027fb-47f2-4471-90c5-1e8b4bca4238",
          "originId": "7fc6c76b-e681-4ce0-80ce-e439b76d3977",
          "carrierRateId": "8c79ad21-3a08-4ffe-9ca7-f1a950dac678",
          "serviceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1",
          "carrier": "UPS",
          "carrierServiceMethodId": "ups-ground-service-method",
          "carrierServiceName": "UPS(MO)",
          "serviceMethodName": "UPS SurePost",
          "fulfillmentContextId": "11a76d2c-5e66-4b9a-9c0f-8113d8865e3c",
          "effectiveShipDate": "2024-03-21T17:29:51.621Z",
          "estimatedInjectionDate": "2024-03-21T17:29:51.621Z",
          "partnerInjectionProfileId": "a46d73be-f3cf-4ac0-852c-cf7217f106ea",
          "shipiumInjectionProfileId": "a742cd42-80b3-4749-a464-8e04edc883dd",
          "partnerInjectionSiteId": "cb320ed4-73d9-456b-8151-907c4d6aaf07",
          "shipiumInjectionSiteId": "dd21aec2-f169-4c44-b706-541698491474",
          "injectionSiteName": "Injection Site 1A",
          "transportationType": "ground",
          "destinationType": "residential"
        }
      ],
      "serviceMethodsAfterFiltering": [
        {
          "partnerId": "f657deeb-647b-4625-910b-53ea2c5e1458",
          "carrierAccountId": "f887c2d0-c524-4dc8-a4c2-6c3c08f0c120",
          "carrierSettingsId": "427027fb-47f2-4471-90c5-1e8b4bca4238",
          "originId": "7fc6c76b-e681-4ce0-80ce-e439b76d3977",
          "carrierRateId": "8c79ad21-3a08-4ffe-9ca7-f1a950dac678",
          "serviceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1",
          "carrier": "UPS",
          "carrierServiceMethodId": "ups-ground-service-method",
          "carrierServiceName": "UPS(MO)",
          "serviceMethodName": "UPS SurePost",
          "fulfillmentContextId": "11a76d2c-5e66-4b9a-9c0f-8113d8865e3c",
          "effectiveShipDate": "2024-03-21T17:29:51.621Z",
          "estimatedInjectionDate": "2024-03-21T17:29:51.621Z",
          "partnerInjectionProfileId": "a46d73be-f3cf-4ac0-852c-cf7217f106ea",
          "shipiumInjectionProfileId": "a742cd42-80b3-4749-a464-8e04edc883dd",
          "partnerInjectionSiteId": "cb320ed4-73d9-456b-8151-907c4d6aaf07",
          "shipiumInjectionSiteId": "dd21aec2-f169-4c44-b706-541698491474",
          "injectionSiteName": "Injection Site 1A",
          "transportationType": "ground",
          "destinationType": "residential"
        }
      ],
      "zonesByServiceMethodIdentifier": {
        "additionalProp1": "sort_facility"
      },
      "calculatedRates": [
        {
          "destinationAddressType": "residential",
          "destinationCountryCode": "US",
          "effectiveShipDate": "2019-10-28T14:34:55.123456Z",
          "destinationPostalCode": "87121",
          "linearDimensions": {
            "linearUnit": "in",
            "length": 13,
            "width": 12,
            "height": 10
          },
          "packagingMaterial": "box",
          "partnerId": "76abb3d4-8990-4f80-aa13-4c2007cb852a",
          "physicalWeight": 2.3,
          "rateCurrency": "usd",
          "serviceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1",
          "weightUnit": "lb",
          "zoneId": "[usps-zone-2]",
          "carrierId": "usps",
          "createdAt": "2020-09-17T11:36:18-07:00",
          "actualWeight": 3,
          "dimWeight": 2,
          "rateResultType": "rate_match",
          "rateResultDetails": "rate_match",
          "billableWeight": 3,
          "lineItems": [
            {
              "name": "base",
              "rate": 2.3,
              "carrierSurchargeId": "123451239874980",
              "lineItemType": "surcharge"
            }
          ],
          "rate": 3.75,
          "carrierCompareCost": 3.5,
          "carrierInvoiceCost": 2.7,
          "operationalCost": 2.7,
          "adjustedCost": 0,
          "carrierRateRequestInfo": {
            "serviceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1",
            "carrierRateId": "8c79ad21-3a08-4ffe-9ca7-f1a950dac678",
            "carrierSettingsId": "427027fb-47f2-4471-90c5-1e8b4bca4238",
            "zoneId": "[usps-zone-2]",
            "saturdayDelivery": true
          }
        }
      ],
      "filteredServiceMethods": [
        {
          "filterReason": "Does not service destination address",
          "filterReasons": [
            "Does not service destination address",
            "Exceeds maximum weight"
          ],
          "serviceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1"
        }
      ],
      "estimatedDeliverySelectionDetails": {
        "desiredDeliveryDate": "2024-03-21T17:29:51.621Z",
        "estimatedDeliveryDate": "2024-03-21T17:29:51.621Z",
        "cheapestCost": 0,
        "selectedCost": 0,
        "selectedAdjustedCost": 0,
        "selectedCostOverCheapest": 0,
        "selectedBucket": "Ground",
        "selectedCarrierServiceMethodId": "upsmi-parcel-select-service-method",
        "selectedServiceMethodIdentifier": "urn:carrierrate:86c6230a-4a2b-4f9b-8b71-a51627bbbcb2:1",
        "selectedDeliveryEstimateProvenance": "carrier_transit_times",
        "selectedEffectiveShipDate": "2024-03-21T17:29:51.621Z",
        "selectedEstimatedInjectionDate": "2024-03-21T17:29:51.621Z",
        "estimatedDeliveryMatchInfo": {
          "timeInTransitDataType": "partner_provided",
          "redisKey": "tnt:98101:UPS_2ND_DAY_AIR",
          "rawTimeInTransit": 0,
          "timeInTransitDays": 0,
          "timeInTransitModel": "carrier-provided-api",
          "matchInfo": "Matched on origin and destination postal codes"
        },
        "estimatedDeliveryDateId": "905f1b41-ed19-4ded-99e6-8248ae74951c",
        "upgradeCostingConfiguration": {
          "costCurrency": "usd",
          "totalUpgradeCostTolerance": 0,
          "upgradeOverCheapestCostTolerance": 0
        },
        "upgradeSpendLimit": 0,
        "upgradeSpendAtDecisionTime": 0,
        "timeInTransitSourcePreference": [
          "partner_provided"
        ],
        "deliveryDateRequestedAt": "2024-03-21T17:29:51.621Z",
        "ignoreUpgradeSpendLimits": true,
        "serviceMethodResults": [
          {
            "carrierServiceMethodId": "ups-ground-service-method",
            "carrierAccountId": "ba9258de-4f59-4ecc-81bc-773b25c6306d",
            "serviceMethodIdentifier": "1f19ca28-9798-42b2-9e8c-f9c3a72c9bab:dXBzbWktcGFyY2VsLXNlbGVjdC1zZXJ2aWNlLW1ldGhvZDo6NDNjYTI3ZDctZmUzNi00YjI1LTk4MDAtYTdmMTE2ZDIyMTQxOjdiODExNzA0LTlhMTYtNGQzYi1iODQ5LTQzYzcyNzk0MTVhYzpmZTFlMjg1Mi1kNTBiLTQ5OGQtOGIxMC05MGJiMWM5ODFjZTA6dXBzbWk6NWExZWE3MjgtNGJhMi00Y2M2LTg5MmMtMWYxMjJmMzUwNzc1Ojo",
            "labelCost": 0,
            "adjustedLabelCost": 0,
            "costOverCheapest": 0,
            "effectiveShipDate": "2024-03-21T17:29:51.621Z",
            "estimatedInjectionDate": "2024-03-21T17:29:51.621Z",
            "estimatedDeliveryDate": "2024-03-21T17:29:51.621Z",
            "bucket": "string",
            "estimatedDeliveryMatchInfo": {
              "timeInTransitDataType": "partner_provided",
              "redisKey": "string",
              "rawTimeInTransit": 0,
              "timeInTransitDays": 0,
              "timeInTransitModel": "string",
              "matchInfo": "string"
            },
            "provenanceId": "773410ba-b7dd-47b2-b812-11e9bf8c61bd",
            "estimatedDeliveryDateId": "905f1b41-ed19-4ded-99e6-8248ae74951c",
            "timeInTransitSourcePreference": [
              "partner_provided"
            ],
            "requestedAt": "2024-03-21T17:29:51.621Z",
            "ignoreUpgradeSpendLimits": true,
            "saturdayDeliveryEnabled": true,
            "sundayDeliveryEnabled": true
          }
        ],
        "saturdayDeliveryRequested": true,
        "sundayDeliveryRequested": true
      },
      "asOfDate": "2024-03-21T17:29:51.621Z",
      "failoverList": [
        "1f19ca28-9798-42b2-9e8c-f9c3a72c9bab:dXBzbWktcGFyY2VsLXNlbGVjdC1zZXJ2aWNlLW1ldGhvZDo6NDNjYTI3ZDctZmUzNi00YjI1LTk4MDAtYTdmMTE2ZDIyMTQxOjdiODExNzA0LTlhMTYtNGQzYi1iODQ5LTQzYzcyNzk0MTVhYzpmZTFlMjg1Mi1kNTBiLTQ5OGQtOGIxMC05MGJiMWM5ODFjZTA6dXBzbWk6NWExZWE3MjgtNGJhMi00Y2M2LTg5MmMtMWYxMjJmMzUwNzc1Ojo"
      ],
      "serviceLevel": "UPS Ground",
      "originatingPostalCode": "98103"
    },
    "effectiveShipDateTime": "2024-03-21T17:29:51.621Z",
    "estimatedInjectionDateTime": "2024-03-21T17:29:51.621Z",
    "injectionDetails": {
      "requestInjectionProfileId": "5fb44000-2e9c-4d31-aec7-46036323c2ce",
      "partnerInjectionProfileId": "a46d73be-f3cf-4ac0-852c-cf7217f106ea",
      "shipiumInjectionProfileId": "a742cd42-80b3-4749-a464-8e04edc883dd",
      "requestInjectionSiteId": "f7092716-1b4b-4ce6-b4a6-e18b11f16c9d",
      "partnerInjectionSiteId": "cb320ed4-73d9-456b-8151-907c4d6aaf07",
      "shipiumInjectionSiteId": "dd21aec2-f169-4c44-b706-541698491474",
      "injectionCostDetails": {
        "injectionLineItemRate": 2.3,
        "injectionLineItemCurrencyCode": "usd",
        "injectionRateModifier": {
          "modifierType": "flat",
          "modifierValue": 0
        }
      }
    }
  },
  "carrierSelectionDateTime": "2024-03-21T17:29:51.621Z",
  "carrierSelectionExpiration": "2024-03-21T17:29:51.621Z"
}

Request and response fields for API calls

The following tables provide required, conditional, and optional fields for calling the Carrier and Method Selection API. You can find additional support in the Carrier and Method Selection API Reference.

Required fields

Field	Details
`currencyCode`	Type: String Example: `usd` Description: Currency in which all the rates for shipping carrier selection costs will be calculated

Conditional fields

Field	Details
`packagingType.linearDimensions .linearUnit`	Type: String (enumeration) Values: `cm` (centimeter), `in` (inch) Condition: Required if `packagingTypeId` is not included Description: The unit in which linear dimensions are provided
`packagingType.linearDimensions .length`	Type: Number (float) Example: `13` Condition: Required if `packagingTypeId` is not included Description: The longest linear dimension (i.e., the longest side of a box or envelope)
`packagingType.linearDimensions .width`	Type: Number (float) Example: `12` Condition: Required if `packagingTypeId` is not included Description: The second longest linear dimension (i.e., the second longest side of a box or envelope)
`packagingType.linearDimensions .height`	Type: Number (float) Example: `10` Condition: Required if `packagingTypeId` is not included Description: The shortest linear dimension. 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.
`injectionParameters .injectionSiteId`	Type: String Condition: Must be paired with `injectionProfileId` Description: The Shipium ID or the partner-provided ID of an injection site that should be considered during carrier selection. If an injection site ID is specified, it must be accompanied by an injection profile ID.

Optional fields

Field	Details
`shippedDateTime`	Type: String (ISO-8601 date-time) Example: `2025-09-17T20:10:17.123456Z` Description: The timestamp for when a partner shipped the product from their warehouse; the timestamp must be a valid ISO 8601 timestamp.
`packagingType.packagingMaterial`	Type: String (enumeration) Values: `box`, `envelope`, `flat_pack`, `mailing_tube`, `parcel_pallet` Description: The type of packaging used to create the package for the shipment
`packagingType.packagingSizeName`	Type: String Example: `13x12x10 box` Description: A custom name for the packaging
`packagingType.packagingTypeId`	Type: String Example: `ebd94f8b-d390-4c9c-987f-b88343f5bf45` Description: The `packagingTypeId` that was used for this package. When this value is present, the dimensions defined in the partner are used. When this value is absent, `linearDimensions` is required.
`packagingType.packagingWeight .weightUnit`	Type: String (enumeration) Values: `g` (gram), `kg` (kilogram), `lb` (pound), `oz` (ounce) Description: The unit in which weight values are provided
`packagingType.packagingWeight .weight`	Type: Number (float) Example: `50` Description: The value of the weight
`includeEvaluatedServiceMethods InResponse`	Type: Boolean Values: `true` or `false` Description: If `true`, a request will expand information on the response to include unselected service methods that made it through filtering.
`includeLineItemsInEvaluated ServiceMethods`	Type: Boolean Values: `true` or `false` Description: When `true`, a response will include line item information for the returned evaluated service methods, provided that `includeEvaluatedServiceMethodsInResponse` is also set to `true`.
`includeInjectionProfiles`	Type: Boolean Values: `true` or `false` Description: If `true`, service methods from the configured injection profiles will be considered during carrier selection.
`injectionParameters .injectionProfileId`	Type: String Description: The Shipium ID or the partner-provided ID of an injection profile that should be considered during carrier selection
`testMode`	Type: Boolean Values: `true` or `false` Description: If `true`, no actual labels are created, only a representation of the label. No money is charged to the underlying account.
`ignoreRuleSets`	Type: Boolean Values: `true` or `false` Description: When `true`, any configured rule sets will be ignored during carrier selection.
`customsInfo .taxIdentificationNumber`	Type: String Example: `12345` Description: This optional value can be passed to override any tax ID number (also known as an employer identification number, or EIN) that is configured in your network settings.

Response attributes

The Carrier and Method Selection response attributes are defined in the following table.

Response attribute	Description
`carrierSelectionId`	Unique ID of the carrier selection for later reference
`shipiumShipmentId`	The unique identifier for the shipment
`partnerShipmentId`	The optional unique identifier that may be used for the shipment
`shipiumTenantId`	The Shipium-generated tenant ID; when present, this is used to indicate the tenant associated with the shipment.
`partnerTenantId`	The tenant ID provided by your organization; when present, this is used to indicate the tenant associated with the shipment.
`carrierDecision.status`	Defines the result of the carrier selection call; values returned will be `success`, `no_decision`, or `[uncosted](https://docs.shipium.com/v2.0/docs/labels-without-costing)`.
`carrierDecision.statusDetails`	Details explaining the result status; pertinent when the status is `no_decision`
`carrierDecision.partnerId`	Your organization's unique ID
`carrierDecision.carrierAccountId`	Unique ID of the carrier account selected for shipping
`carrierDecision.serviceMethodIdentifier`	Identifier of the specific version of the service method of the shipping carrier selected
`carrierDecision.carrier`	The carrier that was used for delivering the package to your customer
`carrierDecision.carrierServiceName`	The name of the carrier service method selected
`carrierDecision.thirdPartyBilling`	Indicates if the selected service method will be billed to a third party
`carrierDecision.includeEvaluated ServiceMethodsInResponse`	Indicates if you expressed in the request to include the evaluated carrier service methods in the response
`carrierDecision.includeLineItems InEvaluatedServiceMethods`	Indicates if you expressed in the request to include details about the evaluated carrier service methods in the response
`carrierDecision .carrierEstimatedPriceDetails .currencyCode`	Currency in which all price line items are stored
`carrierDecision .carrierEstimatedPriceDetails .shippingCost`	The cost of the shipment charged by the carrier
`carrierDecision .carrierEstimatedPriceDetails .insuranceCost`	The cost of the insurance added to the shipment
`carrierDecision .carrierEstimatedPriceDetails .accessorials`	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
`carrierDecision .carrierEstimatedPriceDetails.duty`	Cost of duties added to the shipment
`carrierDecision .carrierEstimatedPriceDetails.taxes`	Cost of taxes added to the shipment
`carrierDecision .carrierEstimatedPriceDetails.totalCost`	The total cost of the shipment
`carrierDecision .carrierEstimatedPriceDetails .adjustedLabelCost`	Cost used for carrier selection adjusted based on limit minimums
`carrierDecision .carrierEstimatedPriceDetails .carrierCompareCost`	Cost expected to be provided in the carrier response. not including custom adjustments or hidden surcharges
`carrierDecision .carrierEstimatedPriceDetails .carrierInvoiceCost`	Expected cost that the carrier will charge
`carrierDecision .carrierEstimatedPriceDetails .operationalCost`	Carrier invoice cost plus operational costs such as injection line haul
`carrierDecision.serviceMethodName`	Name of the carrier service method selected during the carrier selection process
`carrierDecision.carrierServiceMethodId`	Maps to the unique internal Shipium ID that represents a carrier service method definition; see Supported Carriers for a list of carrier service method IDs.
`carrierDecision .ruleSetProcessingResultSummary.result`	Description of the result of the rule set processing; values returned will be `selection_made` or `no_selection`.
`carrierDecision.ruleSetProcessingResultSummary .selectedCarrierServiceMethodIdentifiers`	Ordered list of service methods selected by the rule set processing if a selection was made
`carrierDecision.ruleSetProcessingResultSummary .ruleMakingSelection.ruleId`	The unique ID of the rule processed
`carrierDecision.ruleSetProcessingResultSummary .ruleMakingSelection.ruleUrn`	The URN of the rule processed
`carrierDecision.ruleSetProcessingResultSummary .ruleMakingSelection.name`	The name of the rule processed
`carrierDecision.ruleSetProcessingResultSummary .ruleSetUrn`	Versioned identifier of the rule set processed
`carrierDecision.ruleSetProcessingResultSummary .processingTimestamp`	The timestamp at which the rule set was processed
`carrierDecision.details.requestParams .currencyCode`	Currency in which all the rates for shipping carrier selection costs will be calculated
`carrierDecision.details.requestParams .shippedDateTime`	Date the shipment is expected to leave the warehouse
`carrierDecision.details.requestParams .packagingType.packagingMaterial`	The type of packaging used to create the package for the shipment
`carrierDecision.details.requestParams .packagingType.packagingSizeName`	A custom name for the packaging
`carrierDecision.details.requestParams .packagingType.packagingTypeId`	Either the Shipium-generated packaging type ID or the packaging type ID provided by your organization that was used for this package
`carrierDecision.details.requestParams .packagingType.linearDimensions`	The linear measurements for the physical size of the package
`carrierDecision.details.requestParams .packagingType.packagingWeight.weightUnit`	The unit in which weight values are provided
`carrierDecision.details.requestParams .packagingType.packagingWeight.weight`	The value of the weight
`carrierDecision.details.requestParams.asOfDate`	Date used to re-create a carrier selection as of a certain point in time
`carrierDecision.details.requestParams .includeEvaluatedServiceMethodsInResponse`	Indicates if you expressed in the request to include the evaluated carrier service methods in the response
`carrierDecision.details.requestParams .includeInjectionProfiles`	When `true`, service methods from the configured injection profiles will be considered during carrier selection.
`carrierDecision.details.requestParams .injectionParameters.injectionProfileId`	The Shipium ID or the ID you provided of an injection profile that should be considered during carrier selection
`carrierDecision.details.requestParams .injectionParameters.injectionSiteId`	The Shipium ID or the ID you provided of an injection site that should be considered during carrier selection
`carrierDecision.details.requestParams.testMode`	Indicates that carrier selection will consider carriers and service methods in test mode
`carrierDecision.details.availableServiceMethods .partnerId`	Your organization's unique ID
`carrierDecision.details.availableServiceMethods .carrierAccountId`	Unique ID of the carrier account linked to this service method
`carrierDecision.details.availableServiceMethods .carrierSettingsId`	Unique ID of the carrier settings linked to this service method
`carrierDecision.details.availableServiceMethods .originId`	Unique ID of the origin linked to this service method
`carrierDecision.details.availableServiceMethods .carrierRateId`	Unique ID of the carrier rate
`carrierDecision.details.availableServiceMethods .serviceMethodIdentifier`	Specific version of the carrier rate
`carrierDecision.details.availableServiceMethods .carrier`	The service method carrier
`carrierDecision.details.availableServiceMethods .carrierServiceMethodId`	Unique ID of the service method for the carrier
`carrierDecision.details.availableServiceMethods .carrierServiceName`	Name of the carrier as defined by your organization
`carrierDecision.details.availableServiceMethods .serviceMethodName`	Name of the service method for the carrier
`carrierDecision.details.availableServiceMethods .fulfillmentContextId`	The Shipium identifier for the fulfillment context associated with this service method
`carrierDecision.details.availableServiceMethods .effectiveShipDate`	The estimated date that the service method will leave the origin
`carrierDecision.details.availableServiceMethods .estimatedInjectionDate`	The estimated date that the service method will arrive at the injection site
`carrierDecision.details.availableServiceMethods .partnerInjectionProfileId`	Unique to your organization's asset ID that you provided to the injection profile
`carrierDecision.details.availableServiceMethods .shipiumInjectionProfileId`	Injection profile identifier
`carrierDecision.details.availableServiceMethods .partnerInjectionSiteId`	Unique to your organization's asset ID that you provided to the injection site
`carrierDecision.details.availableServiceMethods .shipiumInjectionSiteId`	Injection site identifier
`carrierDecision.details.availableServiceMethods .injectionSiteName`	Injection site name
`carrierDecision.details.availableServiceMethods .transportationType`	Transportation type of the service method
`carrierDecision.details.availableServiceMethods .destinationType`	Destination type of the service method
`carrierDecision.details.serviceMethodsAfter Filtering`	Carrier service methods remaining after eligibility filters
`carrierDecision.details.zonesByServiceMethod Identifier`	Mapping of service method identifier to zone calculated; only service methods remaining after the service method filter step will have zone information here.
`carrierDecision.details.calculatedRates .destinationAddressType`	The type of address for this destination
`carrierDecision.details.calculatedRates .destinationCountryCode`	The ISO 3166-1 country code for the destination address
`carrierDecision.details.calculatedRates .effectiveShipDate`	A valid ISO 8601 timestamp representing the time that was used when looking at rate tables
`carrierDecision.details.calculatedRates .destinationPostalCode`	A destination country code appropriate postal code for the destination address
`carrierDecision.details.calculatedRates .linearDimensions`	The linear measurements for the physical size of the package
`carrierDecision.details.calculatedRates .packagingMaterial`	The type of packaging use to create the package
`carrierDecision.details.calculatedRates .partnerId`	The Shipium-generated partner ID
`carrierDecision.details.calculatedRates .physicalWeight`	The weight of the package and all its contents
`carrierDecision.details.calculatedRates .rateCurrency`	The currency of the rate
`carrierDecision.details.calculatedRates .serviceMethodIdentifier`	An urn used to find the service method/carrier rate
`carrierDecision.details.calculatedRates .weightUnit`	The unit in which the weight fields are represented
`carrierDecision.details.calculatedRates .zoneId`	The zone ID that was used for rate shopping
`carrierDecision.details.calculatedRates .carrierId`	The carrier ID for the carrier that was used for rate shopping
`carrierDecision.details.calculatedRates .createdAt`	When the rate response was created
`carrierDecision.details.calculatedRates .actualWeight`	Weight calculated based on physical weight; this value is represented as Rounded Weight in the Shipium Console.
`carrierDecision.details.calculatedRates .dimWeight`	Weight calculated based on linear dimensions
`carrierDecision.details.calculatedRates .rateResultType`	Result from trying to match against rate tables
`carrierDecision.details.calculatedRates .rateResultDetails`	Information on why or why not a rate result was calculated
`carrierDecision.details.calculatedRates .billableWeight`	Weight that was used to generate the rate
`carrierDecision.details.calculatedRates .lineItems.name`	The name of the rate modification
`carrierDecision.details.calculatedRates .lineItems.rate`	The amount of the rate modification
`carrierDecision.details.calculatedRates .lineItems.carrierSurchargeId`	The identifier for the carrier surcharge
`carrierDecision.details.calculatedRates .lineItems.lineItemType`	The type of rate line item for this rate modification
`carrierDecision.details.calculatedRates .rate`	List of rate modifications that were used to calculate the rate
`carrierDecision.details.calculatedRates .carrierCompareCost`	Estimated cost not including hidden surcharges or rate sheet modifiers your organization has
`carrierDecision.details.calculatedRates .carrierInvoiceCost`	Expected cost that the carrier will charge
`carrierDecision.details.calculatedRates .operationalCost`	Carrier invoice cost plus operational costs such as injection line haul
`carrierDecision.details.calculatedRates .adjustedCost`	The cost after being adjusted based on limit minimums
`carrierDecision.details.calculatedRates .carrierRateRequestInfo .serviceMethodIdentifier`	Unique identifier of the service method to be passed back in the response
`carrierDecision.details.calculatedRates .carrierRateRequestInfo.carrierRateId`	Unique identifier of the carrier rate
`carrierDecision.details.calculatedRates .carrierRateRequestInfo.carrierSettingsId`	Unique identifier of the carrier settings
`carrierDecision.details.calculatedRates .carrierRateRequestInfo.zoneId`	Unique identifier of the zone
`carrierDecision.details.calculatedRates .carrierRateRequestInfo.saturdayDelivery`	If `true`, this indicates that there is a request for Saturday delivery.
`carrierDecision.details .filteredServiceMethods.filterReason`	The first reason that this service method was filtered
`carrierDecision.details .filteredServiceMethods.filterReasons`	The list of reasons that this service method was filtered
`carrierDecision.details .filteredServiceMethods .serviceMethodIdentifier`	The string used to identify the service method for your organization
`carrierDecision.details.estimatedDelivery SelectionDetails.desiredDeliveryDate`	The provided desired delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryDate`	The estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.cheapestCost`	The cost for the cheapest option after filtration
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedCost`	The cost for the option that was selected
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedAdjustedCost`	The cost for the option that was selected after adjusting to meet miniumum limits
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedCostOverCheapest`	The cost of the selected item over the cheapest option
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedBucket`	The bucket containing the selected service method
`carrierDecision.details .estimatedDeliverySelectionDetails .selectedCarrierServiceMethodId`	The carrier service method ID of the selected service method
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedServiceMethod Identifier`	The string used to identify the service method for your organization
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedDeliveryEstimate Provenance`	The provenance of the data that was used to calculate estimated shipping days
`carrierDecision.details.estimatedDelivery SelectionDetails.selectedEffectiveShipDate`	The ship date used to determine the estimated delivery date
`carrierDecision.details .estimatedDeliverySelectionDetails .selectedEstimatedInjectionDate`	If injection, the ship date used to determine the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .timeInTransitDataType`	The type of time-in-transit data used to generate the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .redisKey`	The Redis key used to retrieve the time-in-transit data, if Redis is the estimate source
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .rawTimeInTransit`	The raw time-in-transit value from the source
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .timeInTransitDays`	The number of days the package is expected to take in transit
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .timeInTransitModel`	The ML model used to retrieve the time-in-transit data, if ML is the estimate source
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryMatchInfo .matchInfo`	Information about the time-in-transit data match
`carrierDecision.details.estimatedDelivery SelectionDetails.estimatedDeliveryDateId`	The identifier of the data that was used to calculate the estimated delivery day
`carrierDecision.details.estimatedDelivery SelectionDetails.upgradeCostingConfiguration`	Your organization's configuration describing your costing tolerances
`carrierDecision.details.estimatedDelivery SelectionDetails.upgradeSpendLimit`	The cumulative limit that you have set on upgrade spend
`carrierDecision.details.estimatedDelivery SelectionDetails.upgradeSpendAtDecisionTime`	The upgrade spend at the time of the carrier selection decision
`carrierDecision.details.estimatedDelivery SelectionDetails.timeInTransitSourcePreference`	The data source preference list that was used to retrieve time-in-transit data
`carrierDecision.details.estimatedDelivery SelectionDetails.deliveryDateRequestedAt`	The time that the estimated delivery date was requested
`carrierDecision.details.estimatedDelivery SelectionDetails.ignoreUpgradeSpendLimits`	Indicates that upgrade spend limits were ignored in the carrier selection
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .carrierServiceMethodId`	Carrier service method ID
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .carrierAccountId`	ID for your organization's carrier account
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .serviceMethodIdentifier`	The string used to identify the service method for your organization
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults.labelCost`	The cost provided back from the label
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .adjustedLabelCost`	The cost after being adjusted based on limit minimums
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .costOverCheapest`	The cost over the cheapest option
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .effectiveShipDate`	The date we expect the shipment to leave the facility
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .estimatedInjectionDate`	The date we expect the shipment to arrive at the injection site
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .estimatedDeliveryDate`	The date that we estimate this will arrive at the customer
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults.bucket`	The bucket into which this service method was sorted
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .estimatedDeliveryMatchInfo`	Details on the data that was used to get the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .provenanceId`	The provenance of the data that was used to calculate estimated shipping days
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .estimatedDeliveryDateId`	The identifier of the data that was used to calculate the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .timeInTransitSourcePreference`	The data source preference list that was used to retrieve time-in-transit data
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .requestedAt`	The time that the estimate was requested
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .ignoreUpgradeSpendLimits`	Indicates that upgrade spend limits were ignored in the carrier selection
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .saturdayDeliveryEnabled`	Indicates that Saturday delivery was enabled during the calculation of the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.serviceMethodResults .sundayDeliveryEnabled`	Indicates that Sunday delivery was enabled during the calculation of the estimated delivery date
`carrierDecision.details.estimatedDelivery SelectionDetails.saturdayDeliveryRequested`	Indicates that Saturday delivery was requested, either explicitly or because the desired delivery date falls on a Saturday
`carrierDecision.details.estimatedDelivery SelectionDetails.sundayDeliveryRequested`	Indicates that Sunday delivery was requested because the desired delivery date falls on a Sunday
`carrierDecision.details.asOfDate`	Date used to re-create a carrier selection as of a certain point in time
`carrierDecision.details.failoverList`	Ordered list of service method identifiers to be used for failover
`carrierDecision.details.serviceLevel`	Service level of the selected service method
`carrierDecision.details .originatingPostalCode`	Postal code of the shipment's origination
`carrierDecision.effectiveShipDateTime`	The earliest that a shipment can leave the fulfillment center, or origin, based on the shipped date time and the schedules for that origin and the carriers
`carrierDecision.estimatedInjectionDateTime`	The estimate date that the shipment will arrive at the injection site
`carrierDecision.injectionDetails .requestInjectionProfileId`	You can provide either `partnerInjectionProfileId` or `shipiumInjectionProfileId` in the request, and this attribute records / indicates the injection profile identifier you provided in the request.
`carrierDecision.injectionDetails .partnerInjectionProfileId`	Unique to the asset ID that you provided to the injection profile.
`carrierDecision.injectionDetails .shipiumInjectionProfileId`	Injection profile identifier
`carrierDecision.injectionDetails .requestInjectionSiteId`	You can provide either `partnerInjectionSiteId` or `shipiumInjectionSiteId` in the request, and this attribute records / indicates the injection site identifier you provided in the request.
`carrierDecision.injectionDetails .partnerInjectionSiteId`	Unique to the partner asset ID that you provided to the injection site
`carrierDecision.injectionDetails .shipiumInjectionSiteId`	Injection site identifier
`carrierDecision.injectionDetails .injectionCostDetails.injectionLineItemRate`	The amount of the rate modification
`carrierDecision.injectionDetails .injectionCostDetails .injectionLineItemCurrencyCode`	The currency of the rate
`carrierDecision.injectionDetails .injectionCostDetails.injectionRateModifier .modifierType`	The type of the injection rate modifier
`carrierDecision.injectionDetails .injectionCostDetails.injectionRateModifier .modifierValue`	The value of the modification
`carrierSelectionDateTime`	The ISO-8601 formatted date when the carrier selection decision was made
`carrierSelectionExpiration`	The ISO-8601 formatted date defining the point in time when the carrier selection details expire and cannot be acted upon

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: