Create Report Request
POST/api/walmart/:integrationInstance/reports/requests
Create an on-request report request. Walmart generates the report asynchronously; poll its status with Get Report Request Status and fetch the file with Get Report Download URL once it is READY.
Fields:
- report_type (string, required): the type of report to generate, e.g. ITEM.
- report_version (string, optional): the report version; defaults to v1.
Authentication: Requires Bearer token.
Requires the integrations.sync permission.
Request
Responses
- 201
- 401
- 403
- 404
- 422
- 429
Created
Response Headers
Content-Type
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Content-Type
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Content-Type
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.