The ListInfo response group provides descriptive information about a list. ListInfo is a parent response group that returns the results of the ListMinimum response group along with :
List creator
List creation date
List type (WishList, BabyRegistry, etc.)
Date when the list was last modified
For more information about the ListMinimum response group, see its section.
The ListInfo response group is suited for creating a subset of the list information returned by ListFull.
The following table describes the elements returned by ListInfo. 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 | Aditional name of a person the list belongs to |
AverageRating
| List/AverageRating | Average customer rating for item on a list. |
Comment
| List/Comment | Comment |
CustomerName
| List/CustomerName | Name of the list owner. |
CustomerNickname
| List/CustomerNickname | Nickname of list owner |
DateCreated
| List/DateCreated | Date the list was created, in the form yyyy-mm-dd. |
Image
| List/Image | Image in list |
LastModified
| List/LastModified | Date when the list was last modified |
ListId
| List/ListId | A number that uniquely identifies a list. |
ListName
| List/ListName | The name of the list |
ListType
| List/ListType | The list type, such as WishList. |
ListURL
| List/ListURL | URL where you can find the list. The URL is the same for all lists except for the final filename, which is the ListId. In this way you can display the list by just knowing the ListId. |
OccasionDate
| List/OccasionDate | Specifies the date of an occassion, such as a wedding or birthday. |
PartnerName
| List/PartnerName | For wedding registries, this is the name of the bride or groom. |
RegistryName
| List/RegistryName | Name of a wedding or baby registry. |
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 a list has been viewed. |
ListInfo also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.
The following response groups are parent response groups of ListInfo.
The following response groups are child response groups of ListInfo.
The folllowing request was used to illustrate the XML response elements returned by ListInfo.
http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService& AWSAccessKidId=[Access key ID]& Operation=ListSearch& ListType=WishList& Name=John%20Smith& ResponseGroup=ListInfo
The following response snippet shows the elements returned by ListInfo.
<List> <ListId>26ZZZIYUFBASY</ListId> <ListURL>http://www.amazon.com/gp/registry/26ZZZIYUFBASY</ListURL> <ListName>New Wish List</ListName> <ListType>WishList</ListType> <TotalItems>1</TotalItems> <TotalPages>1</TotalPages> <DateCreated>2006-04-13</DateCreated> <CustomerName>john smith</CustomerName> </List>