overlay: 1.0.0
info:
  title: API Evangelist enrichment overlay for Walmart Cost Management Assortment Recommendations Fulfillment API
  version: 1.0.0
extends: walmart-fulfillment-api-openapi.yml
x-generated: '2026-08-27'
x-method: generated
x-source: rate-limits/walmart-rate-limits.yml, conventions/walmart-conventions.yml, errors/walmart-problem-types.yml
x-operations-matched: 19
actions:
- target: $.info
  description: Record API Evangelist provenance and the runtime facts Walmart documents outside the spec.
  update:
    x-apievangelist:
      profile: https://apis.io/provider/walmart/
      enriched: '2026-08-27'
      artifacts:
      - conventions/walmart-conventions.yml
      - errors/walmart-problem-types.yml
      - rate-limits/walmart-rate-limits.yml
      - lifecycle/walmart-lifecycle.yml
      - authentication/walmart-authentication.yml
- target: $.servers
  description: Correct the production host. Walmart publishes this API on marketplace.walmartapis.com in its own OpenAPI (openapi/_original/),
    but the refined servers[] block carries api-gateway.walmart.com, which is the 1P Supplier / Dropship Vendor gateway. The
    original document is left untouched; this overlay records the correction.
  update:
  - url: https://marketplace.walmartapis.com
    description: Walmart Marketplace production
  - url: https://sandbox.walmartapis.com
    description: Walmart sandbox
- target: $
  description: Declare the cross-cutting runtime semantics Walmart documents on the portal but does not express in the contract.
  update:
    x-idempotency:
      supported: false
      note: No idempotency key mechanism is documented anywhere on developer.walmart.com.
    x-rate-limit-headers:
      remaining: x-current-token-count
      reset: X-Next-Replenishment-Time
      exhausted_status: 429
      oversized_payload_status: 413
    x-error-envelope:
      format: proprietary
      shape: '{"errors":[{"code","message","category","severity","field"}]}'
      rfc9457: false
    x-required-headers:
    - WM_SEC.ACCESS_TOKEN
    - WM_QOS.CORRELATION_ID
    - WM_SVC.NAME
    x-deprecation-policy: https://developer.walmart.com/us-marketplace/docs/walmart-marketplace-api-deprecation-guide
- target: $.paths['/v3/items/onhold/search'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 30
      window: hour
      published: 30/hour
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/shipment-tracking'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 2
      window: minute
      published: 2/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/shipment-label'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 20
      window: minute
      published: 20/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/orders-fulfillments'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 600
      window: minute
      published: 600/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 20
      window: minute
      published: 20/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/orders-fulfillments/cancel'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 600
      window: minute
      published: 600/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-shipments'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 32
      window: minute
      published: 32/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-shipments'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 500
      window: minute
      published: 500/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-preview'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 60
      window: hour
      published: 60/hour
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/carrier-rate-quotes'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 8
      window: minute
      published: 8/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/carrier-rate-quote/confirm'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 8
      window: minute
      published: 8/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/carrier-label/{shipmentId}'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 30
      window: minute
      published: 30/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/feeds'].post
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 10
      window: hour
      published: 10/hour
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/report/wfs/getInventoryHealthReport'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 5
      window: minute
      published: 5/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/orders-fulfillments/status'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 20
      window: minute
      published: 20/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inventory-log'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 500
      window: minute
      published: 500/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-shipment-items'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 300
      window: minute
      published: 300/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-shipment-errors'].get
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 10
      window: minute
      published: 10/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
- target: $.paths['/v3/fulfillment/inbound-shipments/{inboundOrderId}'].delete
  description: Attach Walmart's published rate limit for this operation.
  update:
    x-rate-limit:
      limit: 10
      window: minute
      published: 10/min
      scope: per-seller
      algorithm: token-bucket
      source: https://developer.walmart.com/us-marketplace/docs/rate-limiting
x-host-correction: true