---
updatedAt: 2026-04-12T09:30:58.000Z
---

# Update lag time

Update fulfillment lag time for multiple items in a single feed. Lag time is the number of days between when an order is placed and when the item ships. A lag time of 2 days or more may require category-level approval; submit a lag time exception request if needed. Send a JSON or XML feed and set feedType=lagtime. For schema definitions and samples, download 

<a target="_self" href="/file/mp/us/LagTimeException.zip">LagTimeException.zip</a>.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-a77cc26a-f495-49fc-8466-5a54188efd10?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-a77cc26a-f495-49fc-8466-5a54188efd10%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": "Lag Time",
    "version": "1.0",
    "description": "This API allows the retrieval of Lag Time for an item with a given SKU."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/feeds": {
      "post": {
        "tags": [
          "Lag Time"
        ],
        "summary": "Update lag time",
        "description": "Update fulfillment lag time for multiple items in a single feed. Lag time is the number of days between when an order is placed and when the item ships. A lag time of 2 days or more may require category-level approval; submit a lag time exception request if needed. Send a JSON or XML feed and set feedType=lagtime. For schema definitions and samples, download \n\n<a target=\"_self\" href=\"/file/mp/us/LagTimeException.zip\">LagTimeException.zip</a>.",
        "operationId": "updateLagTimeBulk",
        "parameters": [
          {
            "name": "feedType",
            "in": "query",
            "description": "Feed type for this request. Set to `lagtime` to submit lag time updates.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "The access token retrieved in the Token API call",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "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"
          }
        ],
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X 'POST' \n  'https://sandbox.walmartapis.com/v3/feeds?feedType=MP_ITEM&requestType=SHIPPING_CONFIG' \n  -H 'accept: application/xml' \n  -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \n  -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \n  -H 'WM_SVC.NAME: Walmart Service Name' \n  -H 'Content-Type: application/xml' \n  -d '<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<LagTimeFeed xmlns=\"http://walmart.com/\">\n<LagTimeHeader>\n<version>1.0</version>\n</LagTimeHeader>\n<lagTime>\n<sku>30348_KFTest</sku>\n<fulfillmentLagTime>0</fulfillmentLagTime>\n</lagTime>\n<lagTime>\n<sku>10210321</sku>\n<fulfillmentLagTime>0</fulfillmentLagTime>\n</lagTime>\n</LagTimeFeed>'",
              "name": "xml example"
            },
            {
              "language": "curl",
              "code": "curl -X 'POST' \n  'https://sandbox.walmartapis.com/v3/feeds?feedType=MP_ITEM&requestType=SHIPPING_CONFIG' \n  -H 'accept: application/xml' \n  -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \n  -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \n  -H 'WM_SVC.NAME: Walmart Service Name' \n  -H 'Content-Type: application/json' \n -d'{\"LagTimeHeader\":{\"version\":\"1.0\"},\"lagTime\":[{\"sku\":\"30348_KFTest\",\"fulfillmentLagTime\":\"1\"}]}'",
              "name": "JSON example"
            }
          ]
        },
        "requestBody": {
          "description": "File fields",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "lagTimeHeader"
                ],
                "type": "object",
                "properties": {
                  "lagTimeHeader": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string",
                        "description": "Feed schema version for this request. Must match the current version supported for the feed (for example: 1.1, 2.0.20240126-12_25_52-api)."
                      },
                      "feedDate": {
                        "type": "string",
                        "description": "Date and time when the feed was created. Use ISO 8601 UTC format (for example: 2024-07-11T00:29:58Z)."
                      }
                    }
                  },
                  "lagTime": {
                    "type": "array",
                    "xml": {
                      "namespace": "http://walmart.com/"
                    },
                    "items": {
                      "required": [
                        "sku"
                      ],
                      "type": "object",
                      "properties": {
                        "sku": {
                          "type": "string",
                          "description": "A seller-provided Product ID. Response will have decoded value.",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          }
                        },
                        "fulfillmentLagTime": {
                          "type": "integer",
                          "description": "The number of days between when the item is ordered and when it is shipped",
                          "format": "int32",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          }
                        },
                        "additionalAttributes": {
                          "type": "array",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          },
                          "items": {
                            "required": [
                              "name",
                              "value"
                            ],
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Key for the additional attribute. Provide a string that identifies the attribute you’re setting.",
                                "xml": {
                                  "namespace": "http://walmart.com/"
                                }
                              },
                              "value": {
                                "type": "string",
                                "description": "Value for the additional attribute specified by `name`. Provide as a string; the valid format and meaning depend on the attribute.",
                                "xml": {
                                  "namespace": "http://walmart.com/"
                                }
                              }
                            }
                          }
                        }
                      },
                      "xml": {
                        "name": "lagTime"
                      }
                    }
                  }
                },
                "xml": {
                  "name": "lagTimeFeed"
                }
              },
              "examples": {
                "json1": {
                  "value": {
                    "LagTimeHeader": {
                      "version": "1.0"
                    },
                    "lagTime": [
                      {
                        "sku": "30348_KFTest",
                        "fulfillmentLagTime": "1"
                      }
                    ]
                  }
                }
              }
            },
            "application/xml": {
              "schema": {
                "required": [
                  "lagTimeHeader"
                ],
                "type": "object",
                "properties": {
                  "lagTimeHeader": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string",
                        "description": "Feed schema version for this request. Must match the current version supported for the feed (for example: 1.1, 2.0.20240126-12_25_52-api)."
                      },
                      "feedDate": {
                        "type": "string",
                        "description": "Date and time when the feed was created. Use ISO 8601 UTC format (for example: 2024-07-11T00:29:58Z)."
                      }
                    }
                  },
                  "lagTime": {
                    "type": "array",
                    "xml": {
                      "namespace": "http://walmart.com/"
                    },
                    "items": {
                      "required": [
                        "sku"
                      ],
                      "type": "object",
                      "properties": {
                        "sku": {
                          "type": "string",
                          "description": "A seller-provided Product ID. Response will have decoded value.",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          }
                        },
                        "fulfillmentLagTime": {
                          "type": "integer",
                          "description": "The number of days between when the item is ordered and when it is shipped",
                          "format": "int32",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          }
                        },
                        "additionalAttributes": {
                          "type": "array",
                          "xml": {
                            "namespace": "http://walmart.com/"
                          },
                          "items": {
                            "required": [
                              "name",
                              "value"
                            ],
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Key for the additional attribute. Provide a string that identifies the attribute you’re setting.",
                                "xml": {
                                  "namespace": "http://walmart.com/"
                                }
                              },
                              "value": {
                                "type": "string",
                                "description": "Value for the additional attribute specified by `name`. Provide as a string; the valid format and meaning depend on the attribute.",
                                "xml": {
                                  "namespace": "http://walmart.com/"
                                }
                              }
                            }
                          }
                        }
                      },
                      "xml": {
                        "name": "lagTime"
                      }
                    }
                  }
                },
                "xml": {
                  "name": "lagTimeFeed"
                }
              },
              "examples": {
                "xml1": {
                  "value": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<LagTimeFeed xmlns=\"http://walmart.com/\">\n    <LagTimeHeader>\n        <version>1.0</version>\n    </LagTimeHeader>\n    <lagTime>\n        <sku>30348_KFTest</sku>\n        <fulfillmentLagTime>0</fulfillmentLagTime>\n    </lagTime>\n    <lagTime>\n        <sku>10210321</sku>\n        <fulfillmentLagTime>0</fulfillmentLagTime>\n    </lagTime>\n</LagTimeFeed>\n"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "A unique ID, returned from the Bulk Upload API, used for tracking the Feed File."
                    }
                  }
                },
                "example": {
                  "feedId": "E7BB7DBAF3FF461AB63A2169F3BEAADE@AVQBAgA"
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "A unique ID, returned from the Bulk Upload API, used for tracking the Feed File."
                    }
                  }
                },
                "example": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<ns2:FeedAcknowledgement xmlns:ns2=\"http://walmart.com/\">\n    <ns2:feedId>76D440717BFD429DAD28AC01D42AE90D@AR0BAQA</ns2:feedId>\n</ns2:FeedAcknowledgement>"
              }
            }
          }
        }
      }
    }
  }
}
```