Get Carrier Rate Quotes
POST/api/walmart/:integrationInstance/wfs/inbound-shipments/:shipment/carrier-rate-quotes
Request WFS Preferred-Carrier rate quotes for a shipment. Walmart's payload is built from the shipment's source warehouse (origin/return address) + assigned FC (destination) + the supplied package dimensions. The inbound must have a resolved SOURCE WAREHOUSE (supplier-sourced or unresolved inbounds are rejected). Returns a normalized quote list.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Authentication: Requires Bearer token.
Fields:
- packages (array, required, min 1): one entry per distinct package.
- packages[].weight (numeric, required, min 0): package weight in LB.
- packages[].length (numeric, required, min 0): length in IN.
- packages[].width (numeric, required, min 0): width in IN.
- packages[].height (numeric, required, min 0): height in IN.
- packages[].count (integer, optional, min 1): number of identical packages (default 1).
- pickup_date (date, optional, nullable): requested carrier pickup date.
Each normalized quote: quote_id, carrier, net_charge, currency, transit_days, estimated_delivery, status, mode.
Response: { "data": [ quotes ] }.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.