---
updatedAt: 2026-06-22T19:19:50.000Z
---

# Shipping estimates

This API retrieves shipping cost estimates for available shipping services based on address and package (example, customer address, packaged weight.)

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-9367f313-3a61-4742-996e-36136f2033d9?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-9367f313-3a61-4742-996e-36136f2033d9%26entityType%3Dcollection%26workspaceId%3De352a845-5a81-4cbe-9122-9b33bac31bf3\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Ship With Walmart",
    "version": "1.0",
    "description": "The Ship With Walmart (SWW) APIs enables walmart.com sellers to buy shipping at competitively discounted rates directly from Walmart to ship their goods to US customers."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "accessToken": []
    }
  ],
  "paths": {
    "/v3/shipping/labels/shipping-estimates": {
      "post": {
        "tags": [
          "Ship With Walmart"
        ],
        "summary": "Shipping estimates",
        "description": "This API retrieves shipping cost estimates for available shipping services based on address and package (example, customer address, packaged weight.)",
        "operationId": "getShippingEstimate",
        "x-stability": "beta",
        "security": [
          {
            "accessToken": []
          }
        ],
        "parameters": [
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.\n\n<b style=\"color: green;\">Market availability: Global</b>",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Walmart Service Name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          },
          {
            "in": "header",
            "name": "Accept",
            "description": "The only supported response media type is application/json.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          }
        ],
        "requestBody": {
          "description": "Shipping fields",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "boxDimensions",
                  "fromAddress",
                  "packageType",
                  "toAddress",
                  "purchaseOrderId",
                  "boxItems"
                ],
                "type": "object",
                "properties": {
                  "boxDimensions": {
                    "required": [
                      "boxWeight",
                      "boxWeightUnit"
                    ],
                    "type": "object",
                    "description": "Box dimensions and weight for a shipping package.",
                    "properties": {
                      "boxLength": {
                        "minimum": 0,
                        "type": "number",
                        "description": "Length of the package. Required when packageType is CUSTOM_PACKAGE; not required for other standard package types (e.g., FEDEX_ENVELOPE, FEDEX_PAK) where dimensions are predetermined by the carrier.The Unit is determined by boxDimensionUnit."
                      },
                      "boxWidth": {
                        "minimum": 0,
                        "type": "number",
                        "description": "Width of the package. Required when packageType is CUSTOM_PACKAGE; not required for other standard package types (e.g., FEDEX_ENVELOPE, FEDEX_PAK) where dimensions are predetermined by the carrier.The Unit is determined by boxDimensionUnit."
                      },
                      "boxHeight": {
                        "minimum": 0,
                        "type": "number",
                        "description": "Height of the package. Required when packageType is CUSTOM_PACKAGE; not required for other standard package types (e.g., FEDEX_ENVELOPE, FEDEX_PAK) where dimensions are predetermined by the carrier.The Unit is determined by boxDimensionUnit."
                      },
                      "boxWeight": {
                        "type": "number",
                        "description": "Weight of the package. Required for all package types. The Unit is determined by boxWeightUnit."
                      },
                      "boxDimensionUnit": {
                        "type": "string",
                        "description": "Unit of measurement for the package length, width, and height. Allowed values: IN (inches), FT (feet), CM (centimeters). Required when packageType is CUSTOM_PACKAGE; not required for other standard package types (e.g., FEDEX_ENVELOPE, FEDEX_PAK) where dimensions are predetermined by the carrier.",
                        "enum": [
                          "IN",
                          "FT",
                          "CM"
                        ]
                      },
                      "boxWeightUnit": {
                        "type": "string",
                        "description": "Unit of measurement for the package weight. Allowed values: LB (pounds), KG (kilograms), OZ (ounces).",
                        "enum": [
                          "LB",
                          "KG",
                          "OZ"
                        ]
                      }
                    }
                  },
                  "deliverByDate": {
                    "type": "string",
                    "description": "The estimated delivery date will be fetched from purchase order provided."
                  },
                  "shipByDate": {
                    "type": "string",
                    "description": "The ship by date will be fetched from purchase order provided."
                  },
                  "fromAddress": {
                    "required": [
                      "addressLines",
                      "city",
                      "countryCode",
                      "postalCode",
                      "state"
                    ],
                    "type": "object",
                    "properties": {
                      "postalCode": {
                        "type": "string",
                        "description": "ZIP or postal code of the seller's fulfillment center."
                      },
                      "countryCode": {
                        "type": "string",
                        "description": "Country code of the seller's fulfillment center (example, US)."
                      },
                      "addressLines": {
                        "type": "array",
                        "description": "Street address lines for the seller's fulfillment center.",
                        "items": {
                          "type": "string",
                          "description": "A single street address line."
                        }
                      },
                      "city": {
                        "type": "string",
                        "description": "City of the seller's fulfillment center."
                      },
                      "state": {
                        "type": "string",
                        "description": "State or province of the seller's fulfillment center. Use the standard two-letter code (example, CA, TX)."
                      }
                    },
                    "description": "Seller's fulfillment center address."
                  },
                  "toAddress": {
                    "required": [
                      "addressLines",
                      "city",
                      "countryCode",
                      "postalCode",
                      "state"
                    ],
                    "type": "object",
                    "properties": {
                      "postalCode": {
                        "type": "string",
                        "description": "ZIP or postal code of the customer's delivery address."
                      },
                      "countryCode": {
                        "type": "string",
                        "description": "Country code of the customer's delivery address (example, US)."
                      },
                      "addressLines": {
                        "type": "array",
                        "description": "Street address lines for the customer's delivery address. Provide up to two lines.",
                        "items": {
                          "type": "string",
                          "description": "A single street address line."
                        }
                      },
                      "city": {
                        "type": "string",
                        "description": "City of the customer's delivery address."
                      },
                      "state": {
                        "type": "string",
                        "description": "State or province of the customer's delivery address. Use the standard two-letter code (example, CA, TX)."
                      }
                    },
                    "description": "To Address - Customer's delivery address."
                  },
                  "carriers": {
                    "type": "array",
                    "description": "Carriers List. This value maps to 'shortName' from All carriers API response.If not provided, it will fetch response for all service types.",
                    "items": {
                      "type": "string",
                      "description": "Carriers List. This value maps to 'shortName' from All carriers API response.If not provided, it will fetch response for all service types."
                    }
                  },
                  "packageType": {
                    "type": "string",
                    "description": "Package Type. This value maps to 'packageTypeShortName' from All carrier package types API response."
                  },
                  "includeServicesNotMeetingDeliveryPromise": {
                    "type": "boolean",
                    "description": "Delivery promise date flag. Pass 'false' if only services meeting promised delivery dates needs to be fetched, else 'true' to fetch all supported delivery dates"
                  },
                  "purchaseOrderId": {
                    "type": "string",
                    "description": "An unique identifier associated with the seller's purchase order."
                  },
                  "boxItems": {
                    "type": "array",
                    "description": "boxItems - A list of items that the seller will be shipping in this package. Each item must correspond to a line item in the specified purchaseOrder. The lineId and SKU fields are used to uniquely identify the specific item being shipped.",
                    "items": {
                      "required": [
                        "lineNumber",
                        "quantity",
                        "sku"
                      ],
                      "type": "object",
                      "properties": {
                        "sku": {
                          "type": "string",
                          "description": "sku of an item"
                        },
                        "quantity": {
                          "type": "integer",
                          "description": "Quantity of Item",
                          "format": "int32"
                        },
                        "lineNumber": {
                          "type": "string",
                          "description": "PO Line Number"
                        }
                      },
                      "description": "boxItems - A list of items that the seller will be shipping in this package. Each item must correspond to a line item in the specified purchaseOrder. The lineId and SKU fields are used to uniquely identify the specific item being shipped."
                    }
                  },
                  "addOns": {
                    "type": "boolean",
                    "description": "addOns flag. Pass 'true' to fetch all addOns cost and we support two add ons type: SIGNATURE and INSURANCE. To get Insurance Estimate, please provide purchaseOrderId and boxItems details. By default, The value of addOns will be false."
                  },
                  "hasBattery": {
                    "type": "boolean",
                    "description": "hasBattery flag. Pass 'true' if the shipment consists of battery. This is a mandatory field for yanwen."
                  }
                }
              },
              "examples": {
                "sample1": {
                  "value": {
                    "packageType": "CUSTOM_PACKAGE",
                    "purchaseOrderId": "91088062299813853",
                    "boxItems": [
                      {
                        "lineNumber": "1",
                        "sku": "sku-1NMeZnK1B1MNJdXde5771022",
                        "quantity": 1
                      }
                    ],
                    "boxDimensions": {
                      "boxWeightUnit": "LB",
                      "boxWeight": 0.8,
                      "boxLength": 6,
                      "boxWidth": 6,
                      "boxHeight": 6,
                      "boxDimensionUnit": "IN"
                    },
                    "shipByDate": "2023-06-05T08:00:00.611Z",
                    "deliverByDate": "2023-06-07T23:00:00.611Z",
                    "carriers": [
                      "FEDEX"
                    ],
                    "fromAddress": {
                      "postalCode": "91776",
                      "countryCode": "US",
                      "addressLines": [
                        "311 E VALLEY BLVD STE 112 PMB 271as"
                      ],
                      "city": "SAN GABRIEL1as",
                      "state": "CA"
                    },
                    "toAddress": {
                      "postalCode": "94085",
                      "countryCode": "US",
                      "addressLines": [
                        "748 N Mathilda Ave",
                        "Room # 224"
                      ],
                      "city": "SUNNYVALE",
                      "state": "CA"
                    },
                    "includeServicesNotMeetingDeliveryPromise": true
                  }
                },
                "sample2": {
                  "value": {
                    "packageType": "CUSTOM_PACKAGE",
                    "purchaseOrderId": "91088062299813853",
                    "boxItems": [
                      {
                        "lineNumber": "1",
                        "sku": "sku-1NMeZnK1B1MNJdXde5771022",
                        "quantity": 1
                      }
                    ],
                    "boxDimensions": {
                      "boxWeightUnit": "LB",
                      "boxWeight": 0.8,
                      "boxLength": 6,
                      "boxWidth": 6,
                      "boxHeight": 6,
                      "boxDimensionUnit": "IN"
                    },
                    "shipByDate": "2023-06-05T08:00:00.611Z",
                    "deliverByDate": "2023-06-07T23:00:00.611Z",
                    "carriers": [
                      "FEDEX"
                    ],
                    "fromAddress": {
                      "postalCode": "91776",
                      "countryCode": "US",
                      "addressLines": [
                        "311 E VALLEY BLVD STE 112 PMB 271as"
                      ],
                      "city": "SAN GABRIEL1as",
                      "state": "CA"
                    },
                    "toAddress": {
                      "postalCode": "94085",
                      "countryCode": "US",
                      "addressLines": [
                        "748 N Mathilda Ave",
                        "Room # 224"
                      ],
                      "city": "SUNNYVALE",
                      "state": "CA"
                    },
                    "addOns": true,
                    "includeServicesNotMeetingDeliveryPromise": true
                  }
                },
                "sample3": {
                  "value": {
                    "packageType": "CUSTOM_PACKAGE",
                    "purchaseOrderId": "91088062299813853",
                    "boxItems": [
                      {
                        "lineNumber": "1",
                        "sku": "sku-1NMeZnK1B1MNJdXde5771022",
                        "quantity": 1
                      }
                    ],
                    "boxDimensions": {
                      "boxWeightUnit": "LB",
                      "boxWeight": 0.8,
                      "boxLength": 6,
                      "boxWidth": 6,
                      "boxHeight": 6,
                      "boxDimensionUnit": "IN"
                    },
                    "shipByDate": "2023-06-05T08:00:00.611Z",
                    "deliverByDate": "2023-06-07T23:00:00.611Z",
                    "carriers": [
                      "YANWEN"
                    ],
                    "fromAddress": {
                      "postalCode": "510599",
                      "countryCode": "CN",
                      "addressLines": [
                        "GuSu District PingLong Road 251 Hao"
                      ],
                      "city": "guangZhouShi",
                      "state": "GD"
                    },
                    "toAddress": {
                      "postalCode": "94085",
                      "countryCode": "US",
                      "addressLines": [
                        "748 N Mathilda Ave",
                        "Room # 224"
                      ],
                      "city": "SUNNYVALE",
                      "state": "CA"
                    },
                    "hasBattery": false,
                    "includeServicesNotMeetingDeliveryPromise": true
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "estimates": {
                          "type": "array",
                          "description": "List of estimates.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "serviceTypeGroupName": {
                                "type": "string",
                                "description": "Service type group name."
                              },
                              "serviceTypeGroupDisplayName": {
                                "type": "string",
                                "description": "Service type group display name."
                              },
                              "name": {
                                "type": "string",
                                "description": "Carrier service type."
                              },
                              "displayName": {
                                "type": "string",
                                "description": "Carrier service type display name."
                              },
                              "estimatedRate": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "number"
                                  },
                                  "currency": {
                                    "type": "string",
                                    "enum": [
                                      "AED",
                                      "AFN",
                                      "ALL",
                                      "AMD",
                                      "ANG",
                                      "AOA",
                                      "ARS",
                                      "AUD",
                                      "AWG",
                                      "AZN",
                                      "BAM",
                                      "BBD",
                                      "BDT",
                                      "BGN",
                                      "BHD",
                                      "BIF",
                                      "BMD",
                                      "BND",
                                      "BOB",
                                      "BRL",
                                      "BSD",
                                      "BTN",
                                      "BWP",
                                      "BYR",
                                      "BZD",
                                      "CAD",
                                      "CDF",
                                      "CHF",
                                      "CLP",
                                      "CNY",
                                      "COP",
                                      "CRC",
                                      "CUP",
                                      "CVE",
                                      "CZK",
                                      "DJF",
                                      "DKK",
                                      "DOP",
                                      "DZD",
                                      "EGP",
                                      "ERN",
                                      "ETB",
                                      "EUR",
                                      "FJD",
                                      "FKP",
                                      "GBP",
                                      "GEL",
                                      "GHS",
                                      "GIP",
                                      "GMD",
                                      "GNF",
                                      "GTQ",
                                      "GYD",
                                      "HKD",
                                      "HNL",
                                      "HRK",
                                      "HTG",
                                      "HUF",
                                      "IDR",
                                      "ILS",
                                      "INR",
                                      "IQD",
                                      "IRR",
                                      "ISK",
                                      "JMD",
                                      "JOD",
                                      "JPY",
                                      "KES",
                                      "KGS",
                                      "KHR",
                                      "KMF",
                                      "KPW",
                                      "KRW",
                                      "KWD",
                                      "KYD",
                                      "KZT",
                                      "LAK",
                                      "LBP",
                                      "LKR",
                                      "LRD",
                                      "LSL",
                                      "LTL",
                                      "LVL",
                                      "LYD",
                                      "MAD",
                                      "MDL",
                                      "MGA",
                                      "MKD",
                                      "MMK",
                                      "MNT",
                                      "MOP",
                                      "MRO",
                                      "MUR",
                                      "MVR",
                                      "MWK",
                                      "MXN",
                                      "MYR",
                                      "MZN",
                                      "NAD",
                                      "NGN",
                                      "NIO",
                                      "NOK",
                                      "NPR",
                                      "NZD",
                                      "OMR",
                                      "PAB",
                                      "PEN",
                                      "PGK",
                                      "PHP",
                                      "PKR",
                                      "PLN",
                                      "PYG",
                                      "QAR",
                                      "RON",
                                      "RSD",
                                      "RUB",
                                      "RUR",
                                      "RWF",
                                      "SAR",
                                      "SBD",
                                      "SCR",
                                      "SDG",
                                      "SEK",
                                      "SGD",
                                      "SHP",
                                      "SLL",
                                      "SOS",
                                      "SRD",
                                      "STD",
                                      "SYP",
                                      "SZL",
                                      "THB",
                                      "TJS",
                                      "TMT",
                                      "TND",
                                      "TOP",
                                      "TRY",
                                      "TTD",
                                      "TWD",
                                      "TZS",
                                      "UAH",
                                      "UGX",
                                      "USD",
                                      "UYU",
                                      "UZS",
                                      "VEF",
                                      "VND",
                                      "VUV",
                                      "WST",
                                      "XAF",
                                      "XAG",
                                      "XAU",
                                      "XBA",
                                      "XBB",
                                      "XBC",
                                      "XBD",
                                      "XCD",
                                      "XDR",
                                      "XFU",
                                      "XOF",
                                      "XPD",
                                      "XPF",
                                      "XPT",
                                      "XTS",
                                      "XXX",
                                      "YER",
                                      "ZAR",
                                      "ZMK",
                                      "ZWL"
                                    ]
                                  }
                                },
                                "description": "Estimated Rate"
                              },
                              "deliveryDate": {
                                "type": "string",
                                "description": "Delivery Date"
                              },
                              "carrierName": {
                                "type": "string",
                                "description": "Carrier Short Name"
                              },
                              "carrierDisplayName": {
                                "type": "string",
                                "description": "Carrier Display Name"
                              },
                              "isDeliveryPromiseFulfilled": {
                                "type": "boolean",
                                "description": "Delivery Promise Fulfilled"
                              },
                              "addOns": {
                                "type": "array",
                                "description": "Add Ons Response",
                                "items": {
                                  "required": [
                                    "charge",
                                    "name"
                                  ],
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "description": "Name of the AddOn type.",
                                      "enum": [
                                        "SIGNATURE",
                                        "INSURANCE"
                                      ]
                                    },
                                    "charge": {
                                      "type": "object",
                                      "properties": {
                                        "amount": {
                                          "type": "number",
                                          "description": "Amount"
                                        },
                                        "currency": {
                                          "type": "string",
                                          "description": "Currency",
                                          "enum": [
                                            "AED",
                                            "AFN",
                                            "ALL",
                                            "AMD",
                                            "ANG",
                                            "AOA",
                                            "ARS",
                                            "AUD",
                                            "AWG",
                                            "AZN",
                                            "BAM",
                                            "BBD",
                                            "BDT",
                                            "BGN",
                                            "BHD",
                                            "BIF",
                                            "BMD",
                                            "BND",
                                            "BOB",
                                            "BRL",
                                            "BSD",
                                            "BTN",
                                            "BWP",
                                            "BYR",
                                            "BZD",
                                            "CAD",
                                            "CDF",
                                            "CHF",
                                            "CLP",
                                            "CNY",
                                            "COP",
                                            "CRC",
                                            "CUP",
                                            "CVE",
                                            "CZK",
                                            "DJF",
                                            "DKK",
                                            "DOP",
                                            "DZD",
                                            "EGP",
                                            "ERN",
                                            "ETB",
                                            "EUR",
                                            "FJD",
                                            "FKP",
                                            "GBP",
                                            "GEL",
                                            "GHS",
                                            "GIP",
                                            "GMD",
                                            "GNF",
                                            "GTQ",
                                            "GYD",
                                            "HKD",
                                            "HNL",
                                            "HRK",
                                            "HTG",
                                            "HUF",
                                            "IDR",
                                            "ILS",
                                            "INR",
                                            "IQD",
                                            "IRR",
                                            "ISK",
                                            "JMD",
                                            "JOD",
                                            "JPY",
                                            "KES",
                                            "KGS",
                                            "KHR",
                                            "KMF",
                                            "KPW",
                                            "KRW",
                                            "KWD",
                                            "KYD",
                                            "KZT",
                                            "LAK",
                                            "LBP",
                                            "LKR",
                                            "LRD",
                                            "LSL",
                                            "LTL",
                                            "LVL",
                                            "LYD",
                                            "MAD",
                                            "MDL",
                                            "MGA",
                                            "MKD",
                                            "MMK",
                                            "MNT",
                                            "MOP",
                                            "MRO",
                                            "MUR",
                                            "MVR",
                                            "MWK",
                                            "MXN",
                                            "MYR",
                                            "MZN",
                                            "NAD",
                                            "NGN",
                                            "NIO",
                                            "NOK",
                                            "NPR",
                                            "NZD",
                                            "OMR",
                                            "PAB",
                                            "PEN",
                                            "PGK",
                                            "PHP",
                                            "PKR",
                                            "PLN",
                                            "PYG",
                                            "QAR",
                                            "RON",
                                            "RSD",
                                            "RUB",
                                            "RUR",
                                            "RWF",
                                            "SAR",
                                            "SBD",
                                            "SCR",
                                            "SDG",
                                            "SEK",
                                            "SGD",
                                            "SHP",
                                            "SLL",
                                            "SOS",
                                            "SRD",
                                            "STD",
                                            "SYP",
                                            "SZL",
                                            "THB",
                                            "TJS",
                                            "TMT",
                                            "TND",
                                            "TOP",
                                            "TRY",
                                            "TTD",
                                            "TWD",
                                            "TZS",
                                            "UAH",
                                            "UGX",
                                            "USD",
                                            "UYU",
                                            "UZS",
                                            "VEF",
                                            "VND",
                                            "VUV",
                                            "WST",
                                            "XAF",
                                            "XAG",
                                            "XAU",
                                            "XBA",
                                            "XBB",
                                            "XBC",
                                            "XBD",
                                            "XCD",
                                            "XDR",
                                            "XFU",
                                            "XOF",
                                            "XPD",
                                            "XPF",
                                            "XPT",
                                            "XTS",
                                            "XXX",
                                            "YER",
                                            "ZAR",
                                            "ZMK",
                                            "ZWL"
                                          ]
                                        }
                                      },
                                      "description": "Charge of add-on type."
                                    },
                                    "declaredValue": {
                                      "type": "object",
                                      "properties": {
                                        "amount": {
                                          "type": "number",
                                          "description": "Amount"
                                        },
                                        "currency": {
                                          "type": "string",
                                          "description": "Currency",
                                          "enum": [
                                            "AED",
                                            "AFN",
                                            "ALL",
                                            "AMD",
                                            "ANG",
                                            "AOA",
                                            "ARS",
                                            "AUD",
                                            "AWG",
                                            "AZN",
                                            "BAM",
                                            "BBD",
                                            "BDT",
                                            "BGN",
                                            "BHD",
                                            "BIF",
                                            "BMD",
                                            "BND",
                                            "BOB",
                                            "BRL",
                                            "BSD",
                                            "BTN",
                                            "BWP",
                                            "BYR",
                                            "BZD",
                                            "CAD",
                                            "CDF",
                                            "CHF",
                                            "CLP",
                                            "CNY",
                                            "COP",
                                            "CRC",
                                            "CUP",
                                            "CVE",
                                            "CZK",
                                            "DJF",
                                            "DKK",
                                            "DOP",
                                            "DZD",
                                            "EGP",
                                            "ERN",
                                            "ETB",
                                            "EUR",
                                            "FJD",
                                            "FKP",
                                            "GBP",
                                            "GEL",
                                            "GHS",
                                            "GIP",
                                            "GMD",
                                            "GNF",
                                            "GTQ",
                                            "GYD",
                                            "HKD",
                                            "HNL",
                                            "HRK",
                                            "HTG",
                                            "HUF",
                                            "IDR",
                                            "ILS",
                                            "INR",
                                            "IQD",
                                            "IRR",
                                            "ISK",
                                            "JMD",
                                            "JOD",
                                            "JPY",
                                            "KES",
                                            "KGS",
                                            "KHR",
                                            "KMF",
                                            "KPW",
                                            "KRW",
                                            "KWD",
                                            "KYD",
                                            "KZT",
                                            "LAK",
                                            "LBP",
                                            "LKR",
                                            "LRD",
                                            "LSL",
                                            "LTL",
                                            "LVL",
                                            "LYD",
                                            "MAD",
                                            "MDL",
                                            "MGA",
                                            "MKD",
                                            "MMK",
                                            "MNT",
                                            "MOP",
                                            "MRO",
                                            "MUR",
                                            "MVR",
                                            "MWK",
                                            "MXN",
                                            "MYR",
                                            "MZN",
                                            "NAD",
                                            "NGN",
                                            "NIO",
                                            "NOK",
                                            "NPR",
                                            "NZD",
                                            "OMR",
                                            "PAB",
                                            "PEN",
                                            "PGK",
                                            "PHP",
                                            "PKR",
                                            "PLN",
                                            "PYG",
                                            "QAR",
                                            "RON",
                                            "RSD",
                                            "RUB",
                                            "RUR",
                                            "RWF",
                                            "SAR",
                                            "SBD",
                                            "SCR",
                                            "SDG",
                                            "SEK",
                                            "SGD",
                                            "SHP",
                                            "SLL",
                                            "SOS",
                                            "SRD",
                                            "STD",
                                            "SYP",
                                            "SZL",
                                            "THB",
                                            "TJS",
                                            "TMT",
                                            "TND",
                                            "TOP",
                                            "TRY",
                                            "TTD",
                                            "TWD",
                                            "TZS",
                                            "UAH",
                                            "UGX",
                                            "USD",
                                            "UYU",
                                            "UZS",
                                            "VEF",
                                            "VND",
                                            "VUV",
                                            "WST",
                                            "XAF",
                                            "XAG",
                                            "XAU",
                                            "XBA",
                                            "XBB",
                                            "XBC",
                                            "XBD",
                                            "XCD",
                                            "XDR",
                                            "XFU",
                                            "XOF",
                                            "XPD",
                                            "XPF",
                                            "XPT",
                                            "XTS",
                                            "XXX",
                                            "YER",
                                            "ZAR",
                                            "ZMK",
                                            "ZWL"
                                          ]
                                        }
                                      },
                                      "description": "Declared value of shipment. This value is applicable in case of INSURANCE add-on type only."
                                    },
                                    "refLink": {
                                      "type": "string",
                                      "description": "Reference link for the add-on type."
                                    },
                                    "status": {
                                      "type": "string",
                                      "description": "Status of the add-on type."
                                    }
                                  },
                                  "description": "List of add-ons returned for the estimate."
                                }
                              }
                            },
                            "description": "List of estimates."
                          }
                        },
                        "alertMessage": {
                          "type": "string",
                          "description": "Alert message displayed when there are issues fetching estimates for the carrier service type."
                        }
                      },
                      "description": "Response payload containing the list of shipping cost estimates for available services."
                    },
                    "errors": {
                      "type": "array",
                      "description": "List of error details describing why the request failed.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "info": {
                            "type": "string",
                            "description": "Additional contextual information about the error."
                          },
                          "code": {
                            "type": "string",
                            "description": "Error code identifying the failure reason."
                          },
                          "field": {
                            "type": "string",
                            "description": "Name of the request field that triggered this error, when applicable."
                          },
                          "description": {
                            "type": "string",
                            "description": "Human-readable description of the error."
                          },
                          "severity": {
                            "type": "string",
                            "description": "Severity level of the error.",
                            "enum": [
                              "EMERG",
                              "ALERT",
                              "CRITICAL",
                              "ERROR",
                              "WARN"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "description": "Category classifying the origin of the error.",
                            "enum": [
                              "APPLICATION",
                              "SERVICE",
                              "REQUEST",
                              "DATA"
                            ]
                          },
                          "httpStatus": {
                            "type": "integer",
                            "description": "HTTP status code associated with this error.",
                            "format": "int32"
                          }
                        },
                        "description": "Error detail object."
                      }
                    }
                  }
                },
                "examples": {
                  "sample1": {
                    "value": {
                      "data": {
                        "estimates": [
                          {
                            "name": "PRIORITY_MAIL",
                            "displayName": "USPS Priority Mail",
                            "deliveryDate": "2023-10-02T23:59:00.000Z",
                            "estimatedRate": {
                              "amount": 7.2,
                              "currency": "USD"
                            },
                            "serviceTypeGroupName": "USPS_DEFAULT",
                            "serviceTypeGroupDisplayName": "Default",
                            "isDeliveryPromiseFulfilled": false,
                            "carrierName": "USPS",
                            "carrierDisplayName": "USPS"
                          },
                          {
                            "name": "FEDEX_GROUND",
                            "displayName": "FedEx US Ground",
                            "deliveryDate": "2023-09-29T23:59:00.000Z",
                            "estimatedRate": {
                              "amount": 11.87,
                              "currency": "USD"
                            },
                            "serviceTypeGroupName": "FEDEX_GROUND",
                            "serviceTypeGroupDisplayName": "FedEx Ground",
                            "isDeliveryPromiseFulfilled": false,
                            "carrierName": "FedEx",
                            "carrierDisplayName": "FedEx"
                          }
                        ],
                        "alertMessage": "We are unable to find a shipping service that would meet this delivery date. You may choose one of the other delivery options below but note that you may be responsible for any late deliveries."
                      }
                    }
                  },
                  "sample2": {
                    "value": {
                      "data": {
                        "estimates": [
                          {
                            "name": "PRIORITY_MAIL",
                            "displayName": "USPS Priority Mail",
                            "deliveryDate": "2023-10-02T23:59:00.000Z",
                            "estimatedRate": {
                              "amount": 7.2,
                              "currency": "USD"
                            },
                            "serviceTypeGroupName": "USPS_DEFAULT",
                            "serviceTypeGroupDisplayName": "Default",
                            "isDeliveryPromiseFulfilled": false,
                            "carrierName": "USPS",
                            "carrierDisplayName": "USPS",
                            "addOns": [
                              {
                                "name": "INSURANCE",
                                "charge": {
                                  "amount": 0.33,
                                  "currency": "USD"
                                },
                                "declaredValue": {
                                  "amount": 40,
                                  "currency": "USD"
                                }
                              }
                            ]
                          },
                          {
                            "name": "FEDEX_GROUND",
                            "displayName": "FedEx US Ground",
                            "deliveryDate": "2023-09-29T23:59:00.000Z",
                            "estimatedRate": {
                              "amount": 11.87,
                              "currency": "USD"
                            },
                            "serviceTypeGroupName": "FEDEX_GROUND",
                            "serviceTypeGroupDisplayName": "FedEx Ground",
                            "isDeliveryPromiseFulfilled": false,
                            "carrierName": "FedEx",
                            "carrierDisplayName": "FedEx",
                            "addOns": [
                              {
                                "name": "INSURANCE",
                                "charge": {
                                  "amount": 0.33,
                                  "currency": "USD"
                                },
                                "declaredValue": {
                                  "amount": 40,
                                  "currency": "USD"
                                }
                              },
                              {
                                "name": "SIGNATURE",
                                "charge": {
                                  "amount": 6.35,
                                  "currency": "USD"
                                }
                              }
                            ]
                          }
                        ],
                        "alertMessage": "We are unable to find a shipping service that would meet this delivery date. You may choose one of the other delivery options below but note that you may be responsible for any late deliveries."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "accessToken": {
        "type": "apiKey",
        "in": "header",
        "name": "WM_SEC.ACCESS_TOKEN",
        "description": "Access token from POST /v3/token (client_credentials grant)."
      }
    }
  }
}
```