Search a seller's listings items

GET

/listings/v4/items/:sellerId

GET

/seller/v1/listings/v4/items/:sellerId

curl -G https://marketplace.walmart.com/seller/v1/listings/v4/items/sellerId \
     -H "Authorization: Bearer <token>" \
     -d marketplaceIds=WALMART_US

{
  "numberOfResults": 1,
  "items": [
    {
      "sku": "string",
      "summaries": [
        {
          "marketplaceId": "WALMART_US",
          "walmartItemId": "string",
          "productType": "string",
          "conditionType": "new_new",
          "status": "BUYABLE",
          "itemName": "string",
          "createdDate": "2024-01-15T09:30:00Z",
          "lastUpdatedDate": "2024-01-15T09:30:00Z",
          "mainImage": {
            "link": "string",
            "height": 1,
            "width": 1
          }
        }
      ],
      "attributes": {},
      "issues": [
        {
          "code": "string",
          "message": "string",
          "severity": "ERROR",
          "attributeNames": [
            "string"
          ]
        }
      ],
      "offers": [
        {
          "marketplaceId": "string",
          "offerType": "B2C",
          "price": {
            "amount": "string",
            "currencyCode": "USD"
          },
          "points": {
            "pointsNumber": 1
          }
        }
      ],
      "fulfillmentAvailability": [
        {
          "fulfillmentChannelCode": "DEFAULT",
          "quantity": 1,
          "leadTimeToDeploy": "string"
        }
      ]
    }
  ],
  "pagination": {
    "nextToken": "string",
    "previousToken": "string"
  }
}

Returns a paginated list of the seller’s listings items. Mirrors Amazon SP-API searchListingsItems so an existing SP-API client can call the seller-level collection endpoint (no SKU in the path) against v4.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

sellerIdstringRequired

Seller identifier

Query parameters

marketplaceIdslist of enumsRequired

Allowed values:

includedDatalist of enumsOptional

pageSizeintegerOptional1-20Defaults to 10

Maximum number of results per page

pageTokenstringOptional

Opaque cursor returned by a previous call for the next page

Response

Success

numberOfResultsinteger

Total number of matching listings items

itemslist of objects

paginationobjectOptional

Errors

400

Bad Request Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error