Fitment error report download
Use the Get Feed Error Report API to download a detailed error report for a submitted feed. Currently supported feed types are FITMENT_ACES and FITMENT_PIES.
If the submitted feed fails to process or is processed without ingestion errors, the API returns 204 No Content with an empty body.
If the submitted feed is processed with ingestion errors, the API returns 200 OK and a zipped CSV that contains line‑item error messages.
Refer to the samples for how to request and save the file.
Endpoint
GET https://marketplace.walmartapis.com/v3/feeds/{feedId}/errorReportPath parameters
| Name | Type | Required | Notes |
|---|---|---|---|
feedId | string | Yes | Identifier returned by the bulk upload. Percent‑encode special characters in URLs (encode @ as %40). |
Query parameters
| Name | Type | Required | Allowed values | Notes |
|---|---|---|---|---|
feedType | string | Yes | FITMENT_ACES, FITMENT_PIES | Feed type for which to download the error report. |
Request sample
curl --request GET \ --url "https://marketplace.walmartapis.com/v3/feeds/F129C19240844B97A3C6AD8F1A2C4997%40AU8BAQA/errorReport?feedType=FITMENT_ACES" \ --header "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ --header "WM_QOS.CORRELATION_ID: 123e4567-e89b-12d3-a456-426614174000" \ --header "WM_SVC.NAME: Walmart Marketplace" \ --header "Accept: application/octet-stream" --output fitment_aces_error_report.zipThe response is a zip file that contains a CSV with per‑item errors. Use
--outputto save the file.
Modify your code
- Check feed status first. Call the Feed Item Status API and ensure the
feedStatusisPROCESSEDbefore requesting the error report. - Handle 204 No Content. If no ingestion errors exist, the API returns 204 with an empty body; do not retry.
- Stream downloads. Save the payload to disk or cloud storage. Avoid loading the entire file into memory for large reports.
- Parse CSV. Expect columns that identify the item (for example, SKU, WPID, index) and error fields (type, code, description).
Note: Column names can vary by feed type. - Retry responsibly. Use exponential backoff for transient 429/5xx responses. Keep the same correlation ID across retries.
Responses
| HTTP status | Meaning | Body | Notes |
|---|---|---|---|
200 OK | Error report available | application/octet-stream (zip containing a CSV) | May include Content‑Disposition with a suggested filename. |
204 No Content | No ingestion errors | none | Returned when the feed had no item‑level errors or the feed did not reach item ingestion. |
400/401/403/404/429/5xx | Error | JSON error envelope | Refer to error model below. |
Error model (JSON)
When a call fails, the API returns the standard error envelope.
| Field | Type | Notes |
|---|---|---|
errors[] | array | Present on validation or system errors. |
errors[].code | string | Error code. |
errors[].field | string | The field that caused the error. |
errors[].description | string | Description of the error. |
errors[].severity | enum | INFO, WARN, ERROR. |
errors[].category | enum | APPLICATION, SYSTEM, REQUEST, DATA. |
errors[].errorIdentifiers.gatewayErrorCategory | enum | INTERNAL_DATA_ERROR, EXTERNAL_DATA_ERROR, SYSTEM_ERROR. |
Result
- A zipped CSV file with line‑item error details when ingestion errors exist.
204 No Contentwhen there are no ingestion errors.
Fitment feed errors
Fitment feeds can return the following errors during validation and ingestion. Use the error details to identify the issue, correct the affected file or item data, and resubmit the feed.
| Error code | Error message |
|---|---|
FITMENT_ERROR_001 | Zip file is empty or corrupted. Fix and upload again. Refer to the knowledge base article for more information. |
FITMENT_ERROR_002 | No XML ACES file in the zip. Include an ACES XML and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_003 | Missing Brand AAIA ID in the XML. Add the ID and retry. |
FITMENT_ERROR_004 | No XML PIES file in the zip. Include a PIES XML and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_005 | Multiple Brand AAIA IDs found. Only one is allowed per XML. |
FITMENT_ERROR_006 | Excel header format is incorrect. Upload a file with the correct headers. Refer to the knowledge base article for more information. |
FITMENT_ERROR_007 | Excel contains formulas. Remove formulas and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_008 | Excel contains newline characters in cells. Remove them and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_009 | Internal system error during processing. Try again later. |
FITMENT_ERROR_010 | Upload request is missing a file. Attach the file and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_011 | Upload request is missing the ingestion type (ACES or PIES). Include it and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_012 | Upload file is missing a file name. Provide a file name and retry. Refer to the knowledge base article for more information. |
FITMENT_ERROR_013 | Upload file name is not a .zip. Use a .zip file name. Refer to the knowledge base article for more information. |
FITMENT_ERROR_014 | Upload request is missing User ID. |
FITMENT_ERROR_015 | Upload request is missing User Name. |
FITMENT_ERROR_017 | AAIA Brand ID is locked out from 3p seller submissions. If you are the rightful brand owner please reach out to [email protected]. |
FITMENT_ERROR_019 | The uploaded XML file is incomplete or has mismatched tags. |
FITMENT_ERROR_020 | The RecordCount is missing in the uploaded file footer |
FITMENT_ERROR_022 | The RecordCount is 0 in the uploaded file footer |
FITMENT_ERROR_023 | Excel file has no records |
FITMENT_ERROR_024 | Both drop down headers are same in Excel file |
FITMENT_ERROR_025 | Invalid Brand ID |
FITMENT_ERROR_026 | Either Brand ID or Brand Name must be provided |
FITMENT_ERROR_027 | Multiple Brand Names in a file |
FITMENT_ERROR_028 | Missing both Brand AAIAID and BrandName in a file |
FITMENT_ERROR_029 | Inconsistent Brand ID and Brand Name format. All rows must have either BrandAAIAID alone, BrandName alone, or both, but cannot have mixed format |
Next steps
- Use the Feed item status API to identify failed items and correlate with the error CSV.
- Fix the affected items and resubmit a new feed.
- Store the file with the correlation ID for audit and support.
Updated 12 days ago

