---
updatedAt: 2026-08-03T17:23:41.000Z
---

# Get All Report Requests

<div class="amber-callout" aria-label="Migration notice"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href ="https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis" style="text-decoration: underline !important; font-weight: 700;">Global Marketplace migration resources</a>.</p></div><br> Fetches a list of all report requests for specified search criteria by using query parameters.You can fetch details of report requests created in the last 30 days only.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-fdacdf9a-7290-4c2e-8e0e-c93add19518b?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-fdacdf9a-7290-4c2e-8e0e-c93add19518b%26entityType%3Dcollection%26workspaceId%3D956a886d-5b0c-4e87-a28b-d31688fc1cc8\"\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": {
    "version": "1.0",
    "title": "On-request Report Management",
    "description": "The On-request Reports API allows you to request reports immediately about your items for faster retrieval. You can request the report, check status on the report availability, and then download the report URL when report is ready. You can also get a list of all reports requested."
  },
  "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/reports/reportRequests": {
      "get": {
        "tags": [
          "On-Request Report"
        ],
        "summary": "Get All Report Requests",
        "description": "<div class=\"amber-callout\" aria-label=\"Migration notice\"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href =\"https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis\" style=\"text-decoration: underline !important; font-weight: 700;\">Global Marketplace migration resources</a>.</p></div><br> Fetches a list of all report requests for specified search criteria by using query parameters.You can fetch details of report requests created in the last 30 days only.",
        "operationId": "getRequestsStatus",
        "parameters": [
          {
            "name": "reportType",
            "in": "query",
            "description": "Type of report for which the request is created. Example, ITEM for Item Report.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "ITEM_MX",
                "INVENTORY_MX"
              ]
            }
          },
          {
            "name": "reportVersion",
            "in": "query",
            "description": "Version of report for which the request is created. Example, v1.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "requestStatus",
            "in": "query",
            "description": "Status of report request. Possible values are RECEIVED, INPROGRESS, READY, ERROR.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "RECEIVED",
                "INPROGRESS",
                "READY",
                "ERROR"
              ]
            }
          },
          {
            "name": "requestSubmissionStartDate",
            "in": "query",
            "description": "Report request submittal start date for range of reports requested, in format: YYYY-MM-DDTHH:mm:ssZ",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "requestSubmissionEndDate",
            "in": "query",
            "description": "Report request submittal end date for range of reports requested, in format YYYY-MM-DDTHH:mm:ssZ",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "WM_MARKET",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "mx"
              ]
            }
          },
          {
            "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_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"
          },
          {
            "in": "header",
            "name": "Accept",
            "description": "Only supported Media Type : application/json",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "page": {
                      "type": "integer",
                      "description": "Current page",
                      "format": "int32"
                    },
                    "totalCount": {
                      "type": "integer",
                      "description": "Number of records fetched.",
                      "format": "int64"
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Number of records to be returned. Default is 10.",
                      "format": "int32"
                    },
                    "nextCursor": {
                      "type": "string",
                      "description": "Used for pagination when more than specified limit (or default 10) records are found. Use this param for next API call. Just have to use this value as query param. Need to pass only the cursor value and not the initial API call query params. For e.g. if ['nextCursor'='reportType=ITEM_MX&requestStatus=ERROR&requestSubmissionStartDate=2021-08-20T10:52:59Z&requestSubmissionEndDate=2021-09-14T10:52:59Z&page=2&limit=1'] then subsequent call to will be [marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_MX&requestStatus=ERROR&requestSubmissionStartDate=2021-08-20T10:52:59Z&requestSubmissionEndDate=2021-09-14T10:52:59Z&page=2&limit=1]. Just have to use nextCursor value instead of query params"
                    },
                    "requests": {
                      "type": "array",
                      "description": "List of requests",
                      "items": {
                        "type": "object",
                        "properties": {
                          "requestId": {
                            "type": "string",
                            "description": "Automated ID generated by system that uniquely identifies the report request.",
                            "format": "uuid"
                          },
                          "requestStatus": {
                            "type": "string",
                            "description": "Status of report request. Possible values are RECEIVED, INPROGRESS, READY, ERROR.",
                            "enum": [
                              "RECEIVED",
                              "INPROGRESS",
                              "READY",
                              "ERROR"
                            ]
                          },
                          "requestSubmissionDate": {
                            "type": "string",
                            "description": "Date and time on which the report request is submitted."
                          },
                          "reportType": {
                            "type": "string",
                            "description": "Type of report for which the request is created. Example, ITEM_MX for Item Report.",
                            "enum": [
                              "ITEM_MX",
                              "INVENTORY_MX"
                            ]
                          },
                          "reportVersion": {
                            "type": "string",
                            "description": "Version of report for which the request is created. Example, v1."
                          },
                          "payload": {
                            "type": "object",
                            "properties": {
                              "rowFilters": {
                                "type": "array",
                                "description": "Row Level filters",
                                "items": {
                                  "type": "object",
                                  "description": "Supertype of all row filters.",
                                  "anyOf": [
                                    {
                                      "title": "EnumFilter",
                                      "required": [
                                        "columnName",
                                        "type"
                                      ],
                                      "type": "object",
                                      "properties": {
                                        "values": {
                                          "type": "array",
                                          "description": "Enum filter values which has to be included in report",
                                          "items": {
                                            "type": "string",
                                            "description": "Enum filter values which has to be included in report"
                                          }
                                        },
                                        "columnName": {
                                          "type": "string",
                                          "description": "Column on which filter has to be applied"
                                        },
                                        "type": {
                                          "type": "string",
                                          "description": "Type of the filter",
                                          "enum": [
                                            "rangeFilter",
                                            "enumFilter"
                                          ]
                                        }
                                      }
                                    },
                                    {
                                      "title": "RangeFilter",
                                      "required": [
                                        "columnName",
                                        "rowFilterType"
                                      ],
                                      "type": "object",
                                      "properties": {
                                        "from": {
                                          "type": "string",
                                          "description": "Filter range start"
                                        },
                                        "to": {
                                          "type": "string",
                                          "description": "Filter range end"
                                        },
                                        "rowFilterType": {
                                          "type": "string",
                                          "description": "Type of the filter",
                                          "enum": [
                                            "rangeFilter",
                                            "enumFilter"
                                          ]
                                        },
                                        "columnName": {
                                          "type": "string",
                                          "description": "Column on which filter has to be applied"
                                        }
                                      }
                                    }
                                  ]
                                }
                              },
                              "excludeColumns": {
                                "type": "array",
                                "description": "Columns to exclude from report",
                                "items": {
                                  "type": "string",
                                  "description": "Columns to exclude from report"
                                }
                              },
                              "dataStartTime": {
                                "type": "string",
                                "description": "Start timestamp of the report date range"
                              },
                              "dataEndTime": {
                                "type": "string",
                                "description": "End timestamp of the report date range"
                              }
                            },
                            "description": "Request Payload"
                          },
                          "reportGenerationDate": {
                            "type": "string",
                            "description": "Date and time on which the report is generated. Attribute is available only if report is generated."
                          }
                        }
                      }
                    }
                  }
                },
                "example": {
                  "page": 1,
                  "totalCount": 15,
                  "limit": 2,
                  "nextCursor": "reportType=ITEM_MX&page=2&limit=2",
                  "requests": [
                    {
                      "requestId": "98884f2c-46c7-48c6-8e19-0946ff371442",
                      "requestStatus": "RECEIVED",
                      "requestSubmissionDate": "2022-09-28T09:14:19",
                      "reportType": "ITEM_MX",
                      "reportVersion": "v1"
                    },
                    {
                      "requestId": "343bb2ab-63c6-4824-b07f-d97e5a7a4147",
                      "requestStatus": "RECEIVED",
                      "requestSubmissionDate": "2022-09-28T04:02:52",
                      "reportType": "ITEM_MX",
                      "reportVersion": "v1",
                      "payload": {
                        "rowFilters": [
                          {
                            "type": "rangeFilter",
                            "columnName": "FECHA DE CREACION DEL ARTICULO",
                            "from": "2022-03-16",
                            "to": "2023-06-16"
                          },
                          {
                            "type": "rangeFilter",
                            "columnName": "FECHA DE ULTIMA ACTUALIZACION DEL ARTICULO",
                            "from": "2022-03-16",
                            "to": "2023-06-16"
                          },
                          {
                            "type": "enumFilter",
                            "columnName": "ESTATUS DE PUBLICACION",
                            "values": [
                              "PUBLISHED",
                              "RETIRED"
                            ]
                          },
                          {
                            "type": "enumFilter",
                            "columnName": "CATEGORIA DEL PRODUCTO",
                            "values": [
                              "Accesorios de Mascotas",
                              "Accesorios Electrónicos"
                            ]
                          }
                        ],
                        "dataStartTime": "2024-08-10T20:11:24.000Z",
                        "dataEndTime": "2024-09-10T20:11:24.000Z"
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}
```