APIHub
Back to Explore

Item API

The Item API allows you to upload item feeds and query the processing status of those feeds (with optional per‑item detail) via versioned GET and POST endpoints under /v2/feeds and /v3/feeds.

Shopping
none
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

1655ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/v2/feeds

Get status of an item feed

  • feedId (query) — The feed ID.
  • includeDetails (query) — Includes the status details for each item in the feed. Do not set this parameter to true as discrepancies may appear between the header and the item details (the item details may be incorrect). Instead, use the Get a feedItems status.
  • offset (query, offset) — The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true.
  • limit (query, limit) — The number of items to be returned. Cannot be more than 50 items. Use it only when the includeDetails is set to true.
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID
POST

/v2/feeds

Upload an item feed

  • feedType (query) — Feed Type
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID
GET

/v2/feeds/{feedId}

Get status of an item within a feed

  • feedId (path, required) — The feed ID
  • includeDetails (query) — Includes details of each entity in the feed. Do not set this parameter to true.
  • offset (query, offset) — The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true.
  • limit (query, limit) — The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true.
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID
GET

/v3/feeds

Get status of an item feed

  • feedId (query) — The feed ID.
  • includeDetails (query) — Includes the status details for each item in the feed. Do not set this parameter to true as discrepancies may appear between the header and the item details (the item details may be incorrect). Instead, use the Get a feedItems status.
  • offset (query, offset) — The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true.
  • limit (query, limit) — The number of items to be returned. Cannot be more than 50 items. Use it only when the includeDetails is set to true.
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID
POST

/v3/feeds

Upload an item feed

  • feedType (query) — Feed Type
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID
GET

/v3/feeds/{feedId}

Get status of an item within a feed

  • feedId (path, required) — The feed ID
  • includeDetails (query) — Includes details of each entity in the feed. Do not set this parameter to true.
  • offset (query, offset) — The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true.
  • limit (query, limit) — The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true.
  • WM_CONSUMER.CHANNEL.TYPE (header, required) — Channel Type
  • WM_CONSUMER.ID (header, required) — Your Consumer ID
  • WM_SEC.TIMESTAMP (header, required) — Epoch timestamp
  • WM_SEC.AUTH_SIGNATURE (header, required) — Authentication signature
  • WM_SVC.NAME (header, required) — The Service name
  • WM_QOS.CORRELATION_ID (header, required) — A Transaction ID

6 endpoints auto-detected

curl -X GET \
  "https://developer.walmart.com/proxy/item-api-doc-app/rest/v2/feeds"

developer.walmart.com · HTTPS only