Choose a reports type

This page helps you select the right on request report for your job. Start with the question you need to answer, pick the report that contains the fields you need, then decide how often to run it and which filters to apply.

How to choose

Identify the outcome. Do you need a catalog snapshot, operational quality metrics, or performance insights.
Confirm the data fields. Open the report guide to check the column list and definitions.
Pick the cadence. Decide if this is a one‑time request or a recurring schedule.
Plan filters. Use row filters, exclude columns, and date ranges to reduce size and speed up processing.

Note: Some reports support filters. Others return a fixed schema. Each report guide states what is supported and provides examples.

Use this page to choose the right on‑request report by job to be done. Each report type links to a guide with request payloads, filters, and example downloads.

Quick selector

Use the tables below to find the report you need. Reports are grouped by business type and include common use cases, supported filters, output formats, scheduling capabilities, and market availability.

Advertising

Report	Use case	Typical filters	Format	Badges	Market(s)
Request an SEM performance report	Analyze advertising campaigns	date range, campaign ID	CSV/ZIP	`filters` `schedulable`	US
Request an SEM search terms report	Analyze search queries	range filter, multi-value filter	CSV/ZIP	`filters` `schedulable`	US

Catalog and growth

Report	Use case	Typical filters	Format	Badges	Market(s)
Request an item report	Catalog status and attributes	SKU or date range	CSV	`filters` `schedulable`	US
Request an assortment recommendations report	Assortment opportunities	category	CSV	`filters` `schedulable`	US
Request a vehicle compatibility coverage report	Vehicle compatibility coverage gaps		CSV	`filters` `schedulable`	US

Inventory and fulfillment readiness

Report	Use case	Typical filters	Format	Badges	Market(s)
Request a lag time report	Lag time hygiene	shipNode	CSV	`filters` `schedulable`	US
Request a shipping configuration report	Shipping configuration audit	shipNode	CSV	`filters` `schedulable`	US
Request a shipping program report	Shipping program eligibility and status	program	CSV	`filters` `schedulable`	US
Request an inventory report	Inventory position by SKU	SKU, shipNode	CSV	`filters` `schedulable`	US

Listing quality

Report	Use case	Typical filters	Format	Badges	Market(s)
Request an item listing quality report	Review quality scores	date range, range filter, enum filter	CSV/ZIP	`filters`	US
Request a content quality report	Review content issues	enum filter	CSV	`filters`	US

Orders and post-purchase quality

Report	Use case	Typical filters	Format	Badges	Market(s)
Request a cancellation report	Order cancellations monitoring	date range	CSV/ZIP	`filters` `schedulable`	US
Request a delivery defect report	Delivery defects tracking	date range	CSV/ZIP	`filters` `schedulable`	US
Request a return item overrides report	Return overrides review	SKU	CSV	`filters` `schedulable`	US

Pricing and performance

Report	Use case	Typical filters	Format	Badges	Market(s)
Request a Buy Box insights report	Buy Box positioning	SKU, category, date range	CSV	`filters` `schedulable`	US
Request a CPA report	Cost‑per‑action (CPA) review	campaign ID, date range	CSV	`filters` `schedulable`	US
Request a promotions report	Promotions audit	promotion ID, date range	CSV/XLSX	`filters` `schedulable`	US
Request an item performance report	Item performance analytics	SKU, category, date range, date grain	CSV/XLSX	`filters` `schedulable` `dateGranularity`	US

Recommendations

Report	Use case	Typical filters	Format	Badges	Market(s)
Request an inventory recommendations report	Inventory recommendations	item ID, GTIN	CSV/XLSV	`filters`	US

Walmart Fulfillment Services (WFS)

Report	Use case	Typical filters	Format	Badges	Market(s)
Request an inventory reconciliation	Inventory reconciling	SKU, date range	CSV	`filters` `schedulable`	US
Request a settlement report	Inventory itemization	date range	CSV	`filters` `schedulable`	US
Request an order report	Orders in a time period	date range	CSV	`filters` `schedulable`	US
Request a customer returns report	Returns in a time period	date range	CSV	`filters` `schedulable`	US

Note: Filter support varies by report. The report guide states which filter types are available and shows payload shapes.

Choosing cadence

Run a one‑time request for audits, large migrations, and catalog checks.
Create a schedule for operational monitoring, alerts, and period‑over‑period analysis.
Pin a report version when you automate schedules to keep schema stable.

Examples

One‑time item report

curl -X POST \ 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM&reportVersion=v6' \ -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "filters": { "rowFilters": [ {"column": "lifecycleStatus", "operator": "IN", "values": ["ACTIVE"]} ], "excludeColumns": ["longDescription", "imageUrl"] } }'

Scheduled item performance report

curl -X POST \ 'https://marketplace.walmartapis.com/v3/reports/schedules' \ -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "reportType": "ITEM_PERFORMANCE", "reportVersion": "v1", "schedule": {"cadence": "WEEKLY", "dayOfWeek": "MONDAY"}, "filters": {"dateRange": {"from": "2025-08-01", "to": "2025-08-31"}} }'

Next steps

Learn how to request and download a report.
Learn how to use report filters.
Set up schedules and status notifications for automation.

Terms

filters: Supports filters when requesting the report.
schedulable: Can be automated via the report scheduler API.

Updated about 1 month ago

Did this page help you?