---
updatedAt: 2026-06-29T21:10:45.000Z
---

# Create Carrier Rate Quote (Legacy)

The purpose of this service is to get the carrier rate quotes for WFS Preferred Carrier Program - FedEx parcel solution, when inbounding seller items from seller pickup point to Walmart fulfillment centers.

For the shipments sent by FedEx small parcel, you can ship packages up to 150 lb, up to 108" in length, and 165" in length plus girth. (Girth is 2x width + 2x height.). You can ship up to 200 packages per shipment.

<div class="callout-light"><strong>Deprecation notice:</strong> This API is in legacy state and will be removed on February 09, 2027. We recommend transitioning to the <a href="https://developer.walmart.com/us-marketplace/reference/createcarrierratequotes">Create Carrier Rate Quote (New)</a> API.</div>

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-4e4731cf-b730-409e-899e-a35aeb947ccb?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-4e4731cf-b730-409e-899e-a35aeb947ccb%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": "Fulfillment Management",
    "version": "1.0",
    "description": "With Walmart Fulfillment Services, you can focus on sales while Walmart expertly take care of fast shipping, seamless returns, and customer service. Simply send your inventory to Walmart fulfillment centers, where we will store your products securely and prepare them swiftly for shipping when an order is placed."
  },
  "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/fulfillment/carrier-rate-quotes": {
      "post": {
        "tags": [
          "Fulfillment"
        ],
        "summary": "Create Carrier Rate Quote (Legacy)",
        "description": "The purpose of this service is to get the carrier rate quotes for WFS Preferred Carrier Program - FedEx parcel solution, when inbounding seller items from seller pickup point to Walmart fulfillment centers.\n\nFor the shipments sent by FedEx small parcel, you can ship packages up to 150 lb, up to 108\" in length, and 165\" in length plus girth. (Girth is 2x width + 2x height.). You can ship up to 200 packages per shipment.\n\n<div class=\"callout-light\"><strong>Deprecation notice:</strong> This API is in legacy state and will be removed on February 09, 2027. We recommend transitioning to the <a href=\"https://developer.walmart.com/us-marketplace/reference/createcarrierratequotes\">Create Carrier Rate Quote (New)</a> API.</div>",
        "operationId": "createCarrierRateQuotes",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Basic YzcyOTFjNmItNzI5MC00...."
          },
          {
            "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_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and used to track and debug issues; use a random 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"
          }
        ],
        "requestBody": {
          "description": "Request fields",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "mode",
                  "originLocation",
                  "shipmentId",
                  "shipmentPackages"
                ],
                "type": "object",
                "properties": {
                  "shipmentId": {
                    "type": "string",
                    "description": "Shipment ID"
                  },
                  "shipmentSource": {
                    "type": "string",
                    "description": "Shipment Source"
                  },
                  "pickupFromDateTime": {
                    "type": "string",
                    "description": "Pickup window opening datetime",
                    "format": "date-time"
                  },
                  "pickupToDateTime": {
                    "type": "string",
                    "description": "Pickup window closing datetime",
                    "format": "date-time"
                  },
                  "deliveryFromDateTime": {
                    "type": "string",
                    "description": "Delivery window opening datetime",
                    "format": "date-time"
                  },
                  "deliveryToDateTime": {
                    "type": "string",
                    "description": "Pickup window closing datetime",
                    "format": "date-time"
                  },
                  "customer": {
                    "required": [
                      "customerId",
                      "customerName"
                    ],
                    "type": "object",
                    "properties": {
                      "customerId": {
                        "type": "string",
                        "description": "Customer ID"
                      },
                      "customerName": {
                        "type": "string",
                        "description": "Customer Name"
                      }
                    },
                    "description": "Customer"
                  },
                  "originLocation": {
                    "required": [
                      "address",
                      "locationName"
                    ],
                    "type": "object",
                    "properties": {
                      "locationName": {
                        "type": "string"
                      },
                      "address": {
                        "required": [
                          "addressLine1",
                          "city",
                          "countryCode",
                          "postalCode",
                          "stateCode"
                        ],
                        "type": "object",
                        "properties": {
                          "addressLine1": {
                            "type": "string"
                          },
                          "addressLine2": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "stateCode": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "postalCode": {
                            "type": "string"
                          },
                          "phone": {
                            "type": "string"
                          }
                        }
                      },
                      "locationId": {
                        "type": "string"
                      }
                    },
                    "description": "Shipment origin location"
                  },
                  "destinationLocation": {
                    "required": [
                      "address",
                      "locationName"
                    ],
                    "type": "object",
                    "properties": {
                      "locationName": {
                        "type": "string"
                      },
                      "address": {
                        "required": [
                          "addressLine1",
                          "city",
                          "countryCode",
                          "postalCode",
                          "stateCode"
                        ],
                        "type": "object",
                        "properties": {
                          "addressLine1": {
                            "type": "string"
                          },
                          "addressLine2": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "stateCode": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "postalCode": {
                            "type": "string"
                          },
                          "phone": {
                            "type": "string"
                          }
                        }
                      },
                      "locationId": {
                        "type": "string"
                      }
                    },
                    "description": "Shipment destination location"
                  },
                  "returnLocation": {
                    "required": [
                      "address",
                      "locationName"
                    ],
                    "type": "object",
                    "properties": {
                      "locationName": {
                        "type": "string"
                      },
                      "address": {
                        "required": [
                          "addressLine1",
                          "city",
                          "countryCode",
                          "postalCode",
                          "stateCode"
                        ],
                        "type": "object",
                        "properties": {
                          "addressLine1": {
                            "type": "string"
                          },
                          "addressLine2": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "stateCode": {
                            "type": "string"
                          },
                          "countryCode": {
                            "type": "string"
                          },
                          "postalCode": {
                            "type": "string"
                          },
                          "phone": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "description": "Return location"
                  },
                  "shipmentPackages": {
                    "maxItems": 500,
                    "minItems": 1,
                    "type": "array",
                    "description": "Number of Shipment Packages",
                    "items": {
                      "required": [
                        "height",
                        "length",
                        "lengthUOM",
                        "packageSequenceNumber",
                        "weight",
                        "weightUOM",
                        "width"
                      ],
                      "type": "object",
                      "properties": {
                        "packageSequenceNumber": {
                          "type": "integer",
                          "description": "Package Sequence Number",
                          "format": "int32"
                        },
                        "weight": {
                          "maximum": 150,
                          "minimum": -1,
                          "type": "number",
                          "description": "Weight",
                          "format": "float"
                        },
                        "weightUOM": {
                          "type": "string",
                          "description": "Weight unit of measurement, should always be \"LB\"",
                          "default": "LB"
                        },
                        "length": {
                          "minimum": -1,
                          "type": "number",
                          "description": "Length",
                          "format": "float"
                        },
                        "height": {
                          "minimum": -1,
                          "type": "number",
                          "description": "Height",
                          "format": "float"
                        },
                        "width": {
                          "minimum": -1,
                          "type": "number",
                          "description": "Width",
                          "format": "float"
                        },
                        "lengthUOM": {
                          "type": "string",
                          "description": "Length unit of measurement, should always be \"IN\"",
                          "default": "IN"
                        },
                        "labelInformation": {
                          "type": "object",
                          "properties": {
                            "labelData": {
                              "type": "string"
                            },
                            "labelFormat": {
                              "type": "string"
                            },
                            "trackingCode": {
                              "type": "string"
                            },
                            "referenceTrackingCode": {
                              "type": "string"
                            },
                            "epTrackerId": {
                              "type": "string"
                            },
                            "shipmentId": {
                              "type": "string"
                            },
                            "packageAsn": {
                              "type": "string"
                            },
                            "masterTrackingCode": {
                              "type": "string"
                            },
                            "master": {
                              "type": "boolean"
                            }
                          }
                        },
                        "billingWeight": {
                          "type": "number",
                          "description": "Billing Weight",
                          "format": "float"
                        },
                        "netCharge": {
                          "type": "number",
                          "format": "float"
                        },
                        "nominalCharge": {
                          "type": "number",
                          "format": "float"
                        },
                        "assessorialCharge": {
                          "type": "number",
                          "format": "float"
                        },
                        "serviceCharge": {
                          "type": "number",
                          "format": "float"
                        },
                        "packageType": {
                          "type": "string",
                          "description": "Package Type"
                        },
                        "noOfPackages": {
                          "type": "integer",
                          "description": "Number of Packages",
                          "format": "int32"
                        },
                        "stackable": {
                          "type": "boolean"
                        }
                      },
                      "description": "List of packages being shipped"
                    }
                  },
                  "mode": {
                    "type": "string",
                    "default": "PARCEL"
                  },
                  "freightClass": {
                    "type": "string"
                  },
                  "declaredValue": {
                    "type": "integer",
                    "format": "int32"
                  },
                  "loadTypes": {
                    "type": "array",
                    "items": {
                      "required": [
                        "count",
                        "loadType"
                      ],
                      "type": "object",
                      "properties": {
                        "count": {
                          "type": "string",
                          "description": "Number of boxes for this load (for `PARCEL` shipments)."
                        },
                        "loadType": {
                          "type": "string",
                          "description": "Allowed value: `PARCEL`. This is the only supported shipment type for WFS."
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "shipmentId": "0089193GDM",
                "mode": "PARCEL",
                "originLocation": {
                  "locationName": "test",
                  "address": {
                    "addressLine1": "860 W California Ave",
                    "addressLine2": "",
                    "city": "Sunnyvale",
                    "stateCode": "CA",
                    "countryCode": "US",
                    "postalCode": "94086",
                    "phone": "2345678901"
                  }
                },
                "shipmentPackages": [
                  {
                    "packageSequenceNumber": 1,
                    "weight": "150",
                    "weightUOM": "LB",
                    "length": "12",
                    "height": "16",
                    "width": "5",
                    "lengthUOM": "IN"
                  }
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "shipmentId": {
                      "type": "string",
                      "description": "Unique ID identifying each shipment"
                    },
                    "shipmentNumber": {
                      "type": "string",
                      "description": "The identifier assigned to the shipment."
                    },
                    "rateQuotes": {
                      "type": "array",
                      "description": "Rate Quotes",
                      "items": {
                        "type": "object",
                        "properties": {
                          "quoteId": {
                            "type": "string"
                          },
                          "estimatedDeliveryDateTime": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "carrier": {
                            "type": "object",
                            "properties": {
                              "carrierId": {
                                "type": "string"
                              },
                              "carrierName": {
                                "type": "string"
                              }
                            }
                          },
                          "currency": {
                            "type": "string"
                          },
                          "discountCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "netCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "surchargeType": {
                            "type": "string"
                          },
                          "surchargeValue": {
                            "type": "string"
                          },
                          "totalBillingWeight": {
                            "type": "number",
                            "format": "float"
                          },
                          "status": {
                            "type": "string"
                          },
                          "transitDays": {
                            "type": "string"
                          },
                          "effectiveDate": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "expiryDate": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "mode": {
                            "type": "string"
                          },
                          "sellerFreightClassCode": {
                            "type": "string"
                          },
                          "freightCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "fuelCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "totalWeight": {
                            "type": "number",
                            "format": "float"
                          },
                          "totalVolume": {
                            "type": "number",
                            "format": "float"
                          },
                          "equipmentTypeCode": {
                            "type": "string"
                          },
                          "serviceCode": {
                            "type": "string"
                          },
                          "numberOfPallets": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "nominalCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "assessorialCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "serviceCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "minimumCharge": {
                            "type": "number",
                            "format": "float"
                          },
                          "declaredValue": {
                            "type": "string"
                          },
                          "mixedSKUs": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "singleSKUs": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "freightReadyDate": {
                            "type": "string",
                            "format": "date-time"
                          }
                        },
                        "description": "Rate Quotes"
                      }
                    }
                  }
                },
                "example": {
                  "shipmentId": "1063602091373948928",
                  "shipmentNumber": "0089193GDM",
                  "rateQuotes": [
                    {
                      "quoteId": "1063602089985634304",
                      "estimatedDeliveryDateTime": "2023-01-23T23:59:00.000Z",
                      "carrier": {
                        "carrierId": "FEDEX",
                        "carrierName": "FEDEX"
                      },
                      "currency": "USD",
                      "discountCharge": 0,
                      "netCharge": 25.42,
                      "totalBillingWeight": 150,
                      "status": "ACTIVE",
                      "rateZoneId": "8",
                      "freightCharge": 0,
                      "fuelCharge": 0,
                      "totalWeight": 0,
                      "totalVolume": 0,
                      "numberOfPallets": 0,
                      "nominalCharge": 0,
                      "assessorialCharge": 0,
                      "serviceCharge": 0,
                      "minimumCharge": 0,
                      "mixedSKUs": 0,
                      "singleSKUs": 0
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "accessToken": {
        "type": "apiKey",
        "in": "header",
        "name": "WM_SEC.ACCESS_TOKEN",
        "description": "An access token required for authenticating API requests. Obtain the token from `POST /v3/token` using the `client_credentials` grant type."
      }
    }
  }
}
```