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}/errorReport

Path parameters

NameTypeRequiredNotes
feedIdstringYesIdentifier returned by the bulk upload. Percent‑encode special characters in URLs (encode @ as %40).

Query parameters

NameTypeRequiredAllowed valuesNotes
feedTypestringYesFITMENT_ACES, FITMENT_PIESFeed 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.zip

The response is a zip file that contains a CSV with per‑item errors. Use --output to save the file.

Modify your code

  1. Check feed status first. Call the Feed Item Status API and ensure the feedStatus is PROCESSED before requesting the error report.
  2. Handle 204 No Content. If no ingestion errors exist, the API returns 204 with an empty body; do not retry.
  3. Stream downloads. Save the payload to disk or cloud storage. Avoid loading the entire file into memory for large reports.
  4. 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.
  5. Retry responsibly. Use exponential backoff for transient 429/5xx responses. Keep the same correlation ID across retries.

Responses

HTTP statusMeaningBodyNotes
200 OKError report availableapplication/octet-stream (zip containing a CSV)May include Content‑Disposition with a suggested filename.
204 No ContentNo ingestion errorsnoneReturned when the feed had no item‑level errors or the feed did not reach item ingestion.
400/401/403/404/429/5xxErrorJSON error envelopeRefer to error model below.

Error model (JSON)

When a call fails, the API returns the standard error envelope.

FieldTypeNotes
errors[]arrayPresent on validation or system errors.
errors[].codestringError code.
errors[].fieldstringThe field that caused the error.
errors[].descriptionstringDescription of the error.
errors[].severityenumINFO, WARN, ERROR.
errors[].categoryenumAPPLICATION, SYSTEM, REQUEST, DATA.
errors[].errorIdentifiers.gatewayErrorCategoryenumINTERNAL_DATA_ERROR, EXTERNAL_DATA_ERROR, SYSTEM_ERROR.

Result

  • A zipped CSV file with line‑item error details when ingestion errors exist.
  • 204 No Content when 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 codeError message
FITMENT_ERROR_001Zip file is empty or corrupted. Fix and upload again. Refer to the knowledge base article for more information.
FITMENT_ERROR_002No XML ACES file in the zip. Include an ACES XML and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_003Missing Brand AAIA ID in the XML. Add the ID and retry.
FITMENT_ERROR_004No XML PIES file in the zip. Include a PIES XML and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_005Multiple Brand AAIA IDs found. Only one is allowed per XML.
FITMENT_ERROR_006Excel header format is incorrect. Upload a file with the correct headers. Refer to the knowledge base article for more information.
FITMENT_ERROR_007Excel contains formulas. Remove formulas and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_008Excel contains newline characters in cells. Remove them and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_009Internal system error during processing. Try again later.
FITMENT_ERROR_010Upload request is missing a file. Attach the file and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_011Upload request is missing the ingestion type (ACES or PIES). Include it and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_012Upload file is missing a file name. Provide a file name and retry. Refer to the knowledge base article for more information.
FITMENT_ERROR_013Upload file name is not a .zip. Use a .zip file name. Refer to the knowledge base article for more information.
FITMENT_ERROR_014Upload request is missing User ID.
FITMENT_ERROR_015Upload request is missing User Name.
FITMENT_ERROR_017AAIA Brand ID is locked out from 3p seller submissions. If you are the rightful brand owner please reach out to [email protected].
FITMENT_ERROR_019The uploaded XML file is incomplete or has mismatched tags.
FITMENT_ERROR_020The RecordCount is missing in the uploaded file footer
FITMENT_ERROR_022The RecordCount is 0 in the uploaded file footer
FITMENT_ERROR_023Excel file has no records
FITMENT_ERROR_024Both drop down headers are same in Excel file
FITMENT_ERROR_025Invalid Brand ID
FITMENT_ERROR_026Either Brand ID or Brand Name must be provided
FITMENT_ERROR_027Multiple Brand Names in a file
FITMENT_ERROR_028Missing both Brand AAIAID and BrandName in a file
FITMENT_ERROR_029Inconsistent 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.

Did this page help you?