---
updatedAt: 2026-09-24T21:33:40.000Z
---

# Valid Tracking Rate Performance Metrics

Returns valid tracking rate metrics, like percent of orders with valid tracking information provided.<br><b style='color:green;'>Market availability: US</b>

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Insights Management",
    "version": "1.0",
    "description": "The Insights Management API provides sellers with actionable information to optimize their listings:\n*   Sellers can locate best-selling items with Trending Items API so they can add those to their catalog of item offerings.\n*   Sellers can find out reasons why items go unpublished, fix the issue and republish those items.\n*   Sellers can use Listing Quality APIs to gather listing quality metrics about their items and find out any post-production issues that they can fix.\n*   Sellers can obtain their overall Listing Quality score, and locate any categories that show items with listing quality issues."
  },
  "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": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/insights/performance/vtr/summary": {
      "get": {
        "tags": [
          "Insight"
        ],
        "summary": "Valid Tracking Rate Performance Metrics",
        "description": "Returns valid tracking rate metrics, like percent of orders with valid tracking information provided.<br><b style='color:green;'>Market availability: US</b>",
        "externalDocs": {
          "description": "Refer to guide",
          "url": "https://sellerhelp.walmart.com/s/guide?language=en_US&article=000007175"
        },
        "operationId": "getVtr",
        "parameters": [
          {
            "$ref": "#/components/parameters/wmGlobalVersion"
          },
          {
            "name": "reportDuration",
            "in": "query",
            "description": "Report duration in days.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 30
            }
          },
          {
            "name": "shippingMethod",
            "in": "query",
            "description": "Shipping method filter",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ALL_METHODS",
                "TWO_DAY",
                "ONE_DAY"
              ]
            }
          },
          {
            "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. Format the credentials as ClientID: ClientSecret before encoding.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Basic YzcyOTFjNmItNzI5MC00...."
          },
          {
            "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.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIxNWNhNGIyYi0yODVjLTQ0ZDUtYmExNC05ZDk1NTlkZmUwNjgiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0...."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to identify 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 that 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": "Specifies the name of the Walmart service being called.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Marketplace"
          },
          {
            "$ref": "#/components/parameters/wmMarket"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "payload": {
                      "type": "object",
                      "properties": {
                        "reportDuration": {
                          "type": "integer",
                          "description": "Past number of days used to calculate the report metrics.",
                          "format": "int32"
                        },
                        "updatedTimestamp": {
                          "type": "string",
                          "description": "Timestamp when metrics are calculated in ISO format"
                        },
                        "shippingMethod": {
                          "type": "string",
                          "description": "Shipping methods used to calculate these metrics",
                          "enum": [
                            "ALL_METHODS",
                            "TWO_DAY",
                            "ONE_DAY"
                          ]
                        },
                        "cumulativeRate": {
                          "type": "number",
                          "description": "Cumulative valid tracking rate",
                          "format": "float"
                        },
                        "cumulativeRateTrend": {
                          "type": "string",
                          "description": "Cumulative valid tracking rate trend",
                          "enum": [
                            "GREEN_UP",
                            "GREEN",
                            "GREEN_DOWN",
                            "YELLOW_UP",
                            "YELLOW",
                            "YELLOW_DOWN",
                            "RED_UP",
                            "RED",
                            "RED_DOWN"
                          ]
                        },
                        "impactedCustomerCount": {
                          "type": "integer",
                          "description": "Number of customers impacted",
                          "format": "int32"
                        },
                        "impactedCustomerTrend": {
                          "type": "string",
                          "description": "Indicates the trend of customer impact. Ranges from positive change, to urgent, to needs to be resolved.",
                          "enum": [
                            "GREEN_UP",
                            "GREEN",
                            "GREEN_DOWN",
                            "YELLOW_UP",
                            "YELLOW",
                            "YELLOW_DOWN",
                            "RED_UP",
                            "RED",
                            "RED_DOWN"
                          ]
                        },
                        "standard": {
                          "type": "string",
                          "description": "[Deprecated] Use performanceStandard. Previously indicated the seller accountable valid tracking rate (VTR) under Walmart performance standards.",
                          "deprecated": true
                        },
                        "performanceStandard": {
                          "type": "string",
                          "description": "Minimum seller accountable valid tracking rate (VTR) as defined by Walmart performance standards."
                        },
                        "riskLevel": {
                          "type": "string",
                          "description": "[Deprecated] Use performanceRiskLevel. Previously indicated the risk level under Walmart performance standards.",
                          "deprecated": true,
                          "enum": [
                            "Meets standard",
                            "Monitor",
                            "Urgent"
                          ]
                        },
                        "performanceRiskLevel": {
                          "type": "string",
                          "description": "Risk level as defined by Walmart performance standards.",
                          "enum": [
                            "GOOD",
                            "MONITOR",
                            "URGENT"
                          ]
                        },
                        "sellerAccountableDrivers": {
                          "type": "object",
                          "properties": {
                            "misleadingTrackingRate": {
                              "type": "number",
                              "description": "Total rate of orders with misleading tracking information",
                              "format": "float"
                            },
                            "nonIntegratedCarrierRate": {
                              "type": "number",
                              "description": "Total rate of orders with non-integrated carriers.",
                              "format": "float"
                            },
                            "invalidTrackingIdRate": {
                              "type": "number",
                              "description": "Total rate of orders with invalid tracking Id",
                              "format": "float"
                            },
                            "invalidTrackingUrlRate": {
                              "type": "number",
                              "description": "Total rate of orders with invalid tracking url",
                              "format": "float"
                            },
                            "noCarrierScanRate": {
                              "type": "number",
                              "description": "Total rate of orders with no carrier scan.",
                              "format": "float"
                            }
                          },
                          "description": "Seller accountable drivers, which impacting the valid tracking rate"
                        },
                        "nonAccountableDrivers": {
                          "type": "object",
                          "properties": {
                            "miscellaneousRate": {
                              "type": "number",
                              "description": "Rate of orders impacted due to miscellaneous reasons",
                              "format": "float"
                            }
                          },
                          "description": "Non-accountable drivers that impact the valid tracking rate."
                        }
                      }
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code of the response. \n",
                      "example": "404"
                    },
                    "description": {
                      "type": "string",
                      "description": "Description of error.\n\n",
                      "example": "HTTP 404 Not Found"
                    },
                    "info": {
                      "type": "string",
                      "description": "Info of error.\n\n",
                      "example": "Requested performance metrics could not be found."
                    },
                    "severity": {
                      "type": "string",
                      "description": "Severity of error.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Category of error.\n\nExample: DATA\n",
                      "example": "DATA"
                    },
                    "causes": {
                      "type": "array",
                      "description": "Causes of error.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Causes of error.",
                        "example": "[]"
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Error identifiers of the error.",
                      "example": {}
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code of the response. \n",
                      "example": "500"
                    },
                    "description": {
                      "type": "string",
                      "description": "Description of error.\n\n",
                      "example": "HTTP 500 Some error occurred"
                    },
                    "severity": {
                      "type": "string",
                      "description": "Severity of error.\n\nExample: ERROR\n",
                      "example": "ERROR"
                    },
                    "category": {
                      "type": "string",
                      "description": "Category of error.\n\nExample: DATA\n",
                      "example": "REQUEST"
                    },
                    "causes": {
                      "type": "array",
                      "description": "Causes of error.",
                      "example": [],
                      "items": {
                        "type": "string",
                        "description": "Causes of error.",
                        "example": "[]"
                      }
                    },
                    "errorIdentifiers": {
                      "type": "object",
                      "description": "Error identifiers of the error.",
                      "example": {}
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "wmMarket": {
        "name": "WM_MARKET",
        "in": "header",
        "description": "Identifies the Walmart Marketplace region for the request. If not specified, US is used by default.<br><b style='color:green;'>Market availability: Global</b>",
        "required": true,
        "schema": {
          "type": "string",
          "enum": [
            "us",
            "ca",
            "mx",
            "cl"
          ]
        }
      },
      "wmGlobalVersion": {
        "name": "WM_GLOBAL_VERSION",
        "in": "header",
        "description": "Indicates the global version of the API. The value must be set to 3.1.<br><b style='color:green;'>Market availability: Global</b>",
        "required": true,
        "schema": {
          "type": "string",
          "enum": [
            "3.1"
          ]
        }
      }
    }
  }
}
```