The ListFull response group provides comprehensive information about a list and the items on it. ListFull is a parent response group that returns the results of the following response groups:
For more information about what is returned by each of these response groups, refer to their sections.
The ListFull response group is ideally suited for creating the contents of a wishlist or Listmania list.
Operations that can use this response group include:
The following table describes the elements returned by ListFull. 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 |
|---|---|---|
AdditionalName
| List/AdditionalName | For baby registries, this field is used for the name of the other parent. |
ASIN
| Item/ASIN | A positive integer distribued by Amazon that uniquely identifies an item on a list. |
AverageRating
| List/AverageRating | Average (between 0 and 5) of customers' ratings of list items. |
Comment
| List/Comment | Comment typically about the purpose of the list. |
Comment
| ListItem/Comment | Comment typically about the purpose of an item on a list. |
CustomerName
| List/CustomerName | The name of the ustomer that created the list. |
CustomerNickname
| List/CustomerNickname | Nickname of the customer that created the list. |
DateAdded
| ListItem/DateAdded | The date an item was added to the list |
DateCreated
| List/DateCreated | The date the list was created. |
Image
| List/Image | An image associated with the list. |
LastModified
| List/LastModified | Date when the list was last updated. |
ListId
| List/ListId | A positive integer distributed by Amazon that uniquely identifies a list. |
ListItemId
| ListItem/ListItemId | A positive integer distributed by Amazon that uniquely identifies an itme on a list. |
| ListName | List/ListName | The name of an item on a list. |
ListType
| List/ListType | The type of list, for example, wedding registry, baby registry, listmania, or wishlist. |
ListURL
| List/ListURL | The URL of the list. |
OccasionDate
| List/OccasionDate | an importatnt date, such as a wedding date, which is associated with a list. |
PartnerName
| List/PartnerName | For wedding registries, this is the name of the bride or groom. |
QuantityDesired
| ListItem/QuantityDesired | The number of specific items desired. |
QuantityReceived
| ListItem/QuantityReceived | The number of specific items received. |
RegistryName
| List/RegistryName | The name on the wedding or baby registry. |
RegistryNumber
| List/RegistryNumber | DEFINITION |
Title
| ItemAttributes/Title | The title of the list. |
TotalItems
| List/TotalItems | Number of items in the list. |
TotalPages
| List/TotalPages | Number of pages of items. There are up to ten items per page.. |
TotalResults
| List/TotalResults | Total number of lists found |
TotalTimesRead
| List/TotalTimesRead | The number of times the list was viewed. |
TotalVotes
| List/TotalVote | The total number of votes cast by customers who reviewed the item. |
ListFull also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.
The following response groups are child response groups of ListFull.
The folllowing request was used to illustrate the XML response elements returned by ListFull.
http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService& AWSAccessKeyId=1V9M7E1ZATWETZDS6W82& Operation=ListLookup& ListType=Listmania& ListId= 2WYHF5M2L9142& ResponseGroup=ListFull
The following response snippet shows the elements returned by ListFull.
<List>
<ListId>2WYHF5M2L9142</ListId>
<ListURL>http://www.amazon.com/gp/richpub/listmania/fullview/2WYHF5M2L9142</ListURL>
<ListName>Popular Christmas Books For Young and Old</ListName>
<ListType>Listmania</ListType>
<TotalItems>25</TotalItems>
<TotalPages>1</TotalPages>
<DateCreated>2003 11 17</DateCreated>
<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>