ADDED Get Latest Report Date V2 API
Walmart Connect is updating the Latest Report Date API response with report-level availability data, helping API partners better understand when Sponsored Search reporting data is ready to access.
- Use the GET /api/v2/latestReportDate endpoint to retrieve the most recent available report date for each supported Snapshot v2 report type. This helps partners confirm data readiness before submitting snapshot report requests.
- The V2 response returns an array of report-level availability objects. Each object includes
reportTypeThe report type associated with the returned latest report date. Each report type may have its own latestReportDate.andResponse FieldlatestReportDateThe latest date for which data is available for the report type..
Format: yyyy-MM-ddResponse Field - After confirming that the required report date is available for your report type, use POST /api/v2/snapshot/report to create a Snapshot v2 report request, then use the Retrieve Snapshot v2 Reports workflow to retrieve the report.
- Use V2 for new integrations. Partners using
GET /api/v1/latestReportDateV1 remains supported and continues to function as-is. However, V1 returns a single global latest report date, while V2 returns report-level availability by report type.should begin migrating toExisting EndpointGET /api/v2/latestReportDateV2 returns the latest available report date for each report type, allowing integrations to determine availability for the specific reports they request., as V1 will be deprecated in a future release cycle.New Endpoint - When upgrading from V1 to V2, update your scheduling or orchestration logic to parse an array response, read the
reportTypeandlatestReportDatevalues from each array item, and filter the response for the report types required by your integration. - For
itemRecommendationsitemRecommendations updates weekly, so its latestReportDate may not advance daily. Add special handling for this report type in your integration., add special handling because itsSupported Report TypelatestReportDateadvances weekly, not daily.
Best Practice: Do not use this endpoint to retrieve report data. Use it only to verify availability before submitting a snapshot request. Call this endpoint once after 10 AM PT and retry no more than once per hour until the current report date is available.
Migration Note: Run V1 and V2 in parallel during your transition period to validate your V2 parsing before retiring the V1 call.
To learn more, see the Get Latest Report Date V2 documentation.
