ListItems Response Group

The ListItems response group describes the items on a list. ListItems is a parent response group that returns the results of the ListMinimum ListMinimumresponse groups along with data associated with each item on a list, including:

ASIN
Title
ListItem ID
Quantity of items desired
Quantity of items received
Item attributes
Universal List Item attributes
Date the item was added to the list

Relevant Operations

Operations that can use this response group include:

ListLookup

Response Elements

The following table describes the elements returned by ListItems.

ListItems also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of ListItems.

None

Child Response Group

The following response groups are child response groups of ListItems.

ListMinimum

Sample REST Use Case

The following request was used to illustrate the XML response elements returned by ListItems.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=ListLookup&
ListType=Listmania&
ListId=2WYHF5M2L9142&
ResponseGroup=ListItems&
Version=2008-08-19
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by ListItems.

<List>
  <ListId>2WYHF5M2L9142</ListId>
  <ListName>Popular Christmas Books For Young and Old</ListName>
  <TotalItems>25</TotalItems>
  <TotalPages>1</TotalPages>
  <ListItem>
    <ListItemId>RI12NH0FJAU5DPX</ListItemId>
    <Item>
      <ASIN>0385508417</ASIN>
      <ItemAttributes>
        <Title>Skipping Christmas</Title>
      </ItemAttributes>
    </Item>
  </ListItem>
  <ListItem>
    <ListItemId>RIA2UFAPEI6GXV</ListItemId>
    <Item>
      <ASIN>0762410698</ASIN>
      <ItemAttributes>
        <Title>The Night Before Christmas: The Heirloom Edition</Title>
      </ItemAttributes>
    </Item>
  </ListItem>
  <ListItem>
    <ListItemId>RI2BKL830IE1GXT</ListItemId>
    <Item>
      <ASIN>0684814994</ASIN>
      <ItemAttributes>
        <Title>Christmas Box</Title>
      </ItemAttributes>
    </Item>
  </ListItem>