Prev		Next

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
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. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response Element	Ancestry	Definition
`ASIN`	Item/ASIN	A number that uniquely identifies an item.
`Comment`	ListItem/Comment	Comment
`DateAdded`	ListItem/DateAdded	Date the item was added to the list.
`ListId`	List/ListId	A number that uniquely identifies a list.
`ListItemId`	ListItem/ListItemId	A number that uniquely identifies an item on a list.
`ListName`	List/ListName	The name of the list.
`QuantityDesired`	ListItem/QuantityDesired	Specifies the quantity desired of a particular item.
`QuantityReceived`	ListItem/QuantityReceived	Specifies the quantity received of a particular item.
`Title`	ItemAttributes/Title	Title of the item.
`TotalPages`	List/TotalPages	Number of pages found. There are up to ten items per page.
`TotalResults`	List/TotalResults	The total number of items found. Only ten are returned per request.

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 folllowing request was used to illustrate the XML response elements returned by ListItems.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[Access Key ID]&
Operation=ListLookup&
ListType=Listmania&
ListId=2WYHF5M2L9142&
ResponseGroup=ListItems

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>